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>  Flight  simulation  work  at  Aeronautical  Resear chTfrabogafeegies 
employs  raster  graphics  for  both  the  presentation  of  visual  scenes 
with  limited  dynamic  content  and  for  the  replication  of  both  flight 
instruments  and  sensor  displays.  The  raster  graphics  system  consists 
of  an  LSI-11/23  microprocessor  (functioning  as  host)  and  three  A.R.L. 
designed  controller  units  coupled  to  RGBS  monitors,  and  is  connected 
through  the  LSI-11/23  to  the  Flight  Simulation  Group  VAX-11/780 
computer.  This  /Memorandum  describes  the  raster  graphic  system, 
and  four  software  packages  which  are  available  to  enable  a  VAX 
user  to  create  and  manipulate  pictures.  These  packages  are:  RJRLSI, 
which  runs  in  the  LSI-11/23  for  communication;  LSILOAD,  for  loading 
and  executing  LSI  programs;  FLISGRAPH,  a  set  of  subroutines 
for  creating  and  manipulating  pictures;  and  MANPIX,  a  utility 
program  which  provides  a  versatile  range  of  picture  manipulation 
capabilities  through  a  simple  set  of  commands,  i 
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1.  INTRODUCTION 


The  unned  flight  alaulator  at  Aeronautical  Research  Laboratories  em¬ 
ploys  raster  graphics  to  eaulate  various  cockpit  instruisents  (such  as  al¬ 
timeter  and  attitude  indicator)*  and  for  this  purpose*  a  low-cost  unit  was 
designed  and  manufactured  at  these  laboratories.  Subsequently*  it  was 
found  that  this  raster  graphic  unit  was  wall-suited  to  other  applications, 
such  as  an  adjunct  in  the  development  of  background  scenes,  and  for 
displaying  real-time  sequences  with  small  dynamic  content  (e.g.  in  air 
traffic  control  tower  simulation*  sea  (1)). 

This  unit  drives  an  RGBS  monitor  and  is  connected  to  the  Plight 
Simulation  Group  VAX-11/780  computer  through  an  LS1-U/23  microcomputer 
which  functions  as  the  graphic  unit's  host.  Several  such  units  can  be  con¬ 
trolled  from  the  VAX  through  the  one  host  LSI-1 1/23.  Pour  software  pac¬ 
kages  are  available  to  enable  a  VAX  user  to  create  and  manipulate  pictures, 
namely  RJRLSI,  LSI LOAD,  FLISGRAPH  and  MANPIX.  RJRLSI  is  a  program  which 
runs  in  the  host  LSI  to  allow  communication  between  the  graphic  controllers 
and  programs  executing  in  the  VAX.  LSILOAD  is  a  VAX  program  which  transmits 
a  user-written  LSI  program  to  the  LSI  and  starts  its  execution.  FLISGRAPH 
is  a  set  of  subroutines  for  picture  manipulation,  and  is  designed  for  use 
with  VAX  Pascal*  FORTRAN  or  MACRO  programs.  MANPIX  is  an  Interactive  prog¬ 
ram  which  enables  a  user  to  perform  a  number  of  display  operations, 
including  the  transmission  of  individual  instructions,  and  the  displaying 
of  single  pictures  or  moving  sequences. 

This  Memorandum  gives  a  brief  description  of  the  raster  graphics  unit  in 
Section  2,  and  describes  the  communication  and  loading  programs,  RJRLSI  and 
LSILOAD,  in  Section  3.  The  subroutine  package,  FLISGRAm,  is  presented  in 
Section  A,  and  Section  5  is  a  user's  guide  for  the  program  MANPIX. 

2.  PLIGHT  SYSTEMS  RASTER  GRAPHICS  SYSTEM 

The  configuration  of  the  system  is  shown  in  Figure  1.  The  host  LSI  is 
coupled  to  the  VAX  via  a  direct  memory  access  (DMA)  link.  There  are  curren¬ 
tly  three  raster  graphic  controllers,  each  of  which  drives  an  RGBS  monitor. 
The  controllers  communicate  with  the  host  LSI  through  separate  DMA  links. 

The  controller  is  the  component  of  the  raster  graphic  unit  that  was 
designed  and  built  at  ARL.  It  has  256  colours,  each  of  which  contains  an 
8-blt  green  field,  a  7-bit  red  field  and  a  6-bit  blue  field.  This  colour 
"map"  can  be  set  up  and  changed  by  program  control.  In  addition,  up  to  four 
of  these  maps  (each  is  termed  a  "quadrant")  can  be  stored  for  different  ap¬ 
plications  (changing  quadrants  alters  the  colours  in  the  whole  picture  - 
not  just  components  yet  to  be  drawn).  The  controller  also  has  eight 
"planes"  each  of  256K  (512  x  512)  bits  of  RAM,  capable  of  storing  an  8-blt 
colour  map  address  for  each  pixel  in  a  512  x  512  picture  array. 

The  Instruction  set  for  the  controller  has  various  features  including 
incremental  moves  snd  operation  in  dump  mode.  The  former  allows  the 
fill-in  of  a  specified  number  of  pixels  (in  any  one  of  the  eight  cardinal 
directions)  in  one  instruction.  Ikimp  mode  operation  allows  the  transfer  of 
part  or  all  of  a  row  or  column  of  pixels  between  the  controller  snd  LSI 
■ewories,  in  either  direction.  Full  details  of  the  instruction  set  are 
presented  in  Appendix  A. 
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3.  HOST  LSI  COMMUNICATION  AMD  LOADING 


3.1  Communication  -  LSI  Profrai  KJKLSI 

The  transmission  of  instructions  to  each  graphic  controller  la  achieved 
by  prograamlng  the  boat  LSI  to  aend  auch  lnatructlona  via  the  appropriate 
DMA  link.  Since  the  VAX  haa  a  very  vereatile  program  debugging  facility 
while  that  of  the  LSI  la  extremely  limited,  it  wax  decided  that  the  boat  LSI 
program  ahould  be  aa  simple  as  possible,  with  the  VAX  handling  the  bulk  of 
instruction  preparation  and  formatting. 

The  program  RJRLSI  is  written  in  PDP-11  MACRO  and  performs  four  basic 
functions: 

(1)  selects  a  controller  aa  current  for  receiving  all  future  instruc¬ 
tions  until  another  controller  is  selected 

(11)  accumulates  in  a  buffer  the  graphic  instructions  sent  by  the  VAX 
for  the  current  controller  (a  separate  buffer  is  maintained  for 
each  controller) 

(ill)  transmits  the  accumulated  instructions  to  the  current  graphic 
controller,  either  upon  request  from  the  VAX  or  when  its  buffer  is 
full 

(lv)  transmits  pixel  data  to  the  VAX  following  a  request  for  the  ex¬ 
ecution  of  a  dump  mode  read-back  operation. 

The  manner  in  which  RJRLSI  operates  is  to  perform  some  initialisation, 
and  then  to  wait  for  signals  from  the  VAX.  RJRLSI  initialises  all  graphic 
controllers  by  setting  their  colour  map  quadrants  to  sero,  loading  into 
each  a  colour  map  comprising  256  green  intensity  levels,  clearing  the 
screens,  and  setting  X  and  Y  pixel  coordinates  to  zero.  It  then  executes  a 
loop  waiting  for  a  signal  from  the  VAX  that  a  data  word  is  ready  for  tran¬ 
smission.  RJRLSI  then  copies  that  word,  and  checks  its  value  to  determine 
subsequent  action  as  follows: 

(i)  value  -  120000  (octal),  120001  (octal)  or  120002  (octal),  inter¬ 
pret  the  value  as  a  command  and  set  the  current  controller  number 
to  0,  1  or  2  according  to  the  two  least  significant  bits  (note 
that  these  16-blt  values  are  all  negative  when  interpreted  as 
signed  integers) 

(11)  value  ■  n,  where  n  >  0,  interpret  n  as  an  integer  and  accept  n 
words  from  the  VAX,  accumulating  them  in  the  current  graphic  con¬ 
troller's  buffer 

(ill)  value  -  0,  transmit  the  accumulated  instructions  (if  any)  to  the 
current  graphic  controller 

(lv)  value  ■  n,  where  n<0  and  not  one  of  the  values  mentioned  in  (i) 
above,  interpret  the  nine  least  significant  bits  as  an  unsigned 
integer  quantity,  m,  and  send  a  dump  mode  instruction  to  the  cur¬ 
rent  controller  to  read  back  m  pairs  of  pixels,  in  the  +X  direc¬ 
tion  if  the  second  most  significant  bit  (bit  14)  of  n  is  clear, 
and  in  the  +Y  direction  if  that  bit  is  set.  Having  read  back  these 
values,  transmit  them  to  the  VAX.  (To  define  the  initial  pixel 
for  the  read-back  operation,  it  is  necessary  to  have  previously 
sent  "set  coordinate"  instructions  from  the  VAX.  For  more  details 
on  the  instruction  set,  see  Appendix  A.) 


3.2  Leading  -  Progran  LSILOAD 

Since  the  host  LSI  hat  no  peripheral  storage  device.  It  Is  necessary  af¬ 
ter  power-up  to  load  and  subsequently  execute  a  progran  which  has  been 
stored  elsewhere.  The  function  of  progran  LSILOAD  is  to  transfer  a  progran 
froa  the  VAX  to  the  LSI,  and  then  to  start  it  executing.  In  order  to  use 
LSILOAD,  it  is  necessary  to  prepare  the  LSI  program  in  absolute  loader  for¬ 
mat.  This  can  be  done  by  coding  in  PDP-11  MACRO,  using  the  ".enabl  abs" 
directive,  and  explicitly  setting  the  value  of  the  progran  counter  (progran 
RJRLS1  uses  this  approach).  If  such  a  progran  is  then  assembled  using  the 
VAX-11  MACRO/RSX  assenbler,  the  resulting  object  file  will  be  in  the  ab¬ 
solute  loader  foraat. 

To  load  an  LSI  progran  from  the  VAX,  the  user  must  firstly  load  the 
prlaary  bootstrap  into  the  LSI.  The  priaary  bootstrap  instructions  for 
transfers  using  LSILOAD  are  listed  in  Appendix  B.  Once  the  bootstrap  is 
loaded  (but  NOT  executing),  the  VAX  program  LSILOAD  is  run.  The  program 
will  lined lately  respond  with 

DON’T  START  THE  BOOT  YET 
Enter  LSI  filename: 

at  which  point  the  user  should  enter  the  name  of  the  LSI  progran  to  be 
loaded.  LSILOAD  will  then  reply  with 

Now  start  the  priaary  boot,  then  enter  <CR> 

The  user  should  then  start  the  execution  of  the  prinary  bootstrap,  and  en¬ 
ter  a  carriage-return.  LSILOAD  will  then  send  a  secondary  bootstrap  to  the 
LSI,  start  its  execution  and  transfer  the  LSI  progran.  When  the  transfer  is 
conplete ,  the  secondary  bootstrap  will  start  the  execution  of  the  LSI 
progran. 

4.  PROGRAMMING  WITH  THE  FL I 5 GRAPH  PACKAGE 

The  FLIS GRAPH  package  consists  of  five  VAX-11  MACRO  subroutines  and  a 
number  of  VAX-11  FORTRAN  subroutines,  all  of  which  nay  be  called  from 
VAX-11  Pascal,  FORTRAN,  or  MACRO  programs  in  order  to  create  or  alter  pic¬ 
tures  on  the  Flight  Systems  Raster  Graphic  display. 

Operating  with  FLISGRAPH  routines  is,  in  most  cases.  Initialised  by  a 
call  to  GRAPHICL.INIT  and  terninated  by  a  call  to  GRAPHIC-FINISH,  with  all 
other  calls  lying  between  these  two.  Certain  utility  routines  within  the 
package  do  not  require  this  discipline,  and  this  fact  will  be  pointed  out 
in  their  descriptions. 

Note  that  at  any  one  tine  a  user  can  connunlcate  with  only  one  of  the 
three  controller  units  of  the  raster  graphics  system.  This  unit  is  refer¬ 
red  to  as  the  "current  controller".  If  it  is  necessary  to  manipulate  the 
picture  on  more  than  one  screen,  each  must  be  selected  in  turn  as  the  cur¬ 
rent  controller  before  changes  can  be  made. 

The  descriptions  of  the  routines  within  the  FLISGRAPH  package  will  now 
be  presented.  Several  of  these  routines  have  optional  arguments,  in  the 
sense  that,  starting  with  the  rlght-nost,  one  or  more  can  be  omitted  and  a 
default  value  will  apply.  Such  arguments  will  be  shown  in  brackets  ([])> 
with  nesting  of  the  brackets  where  appropriate. 


4.1  Initialisation,  Selection  and  Termination  Routines 

4.1.1  Logical  Function  GRAPHIC— IRIT( {code [, error— 11m ])) 

4. 1.1.1  Purpose 

This  routine  allocates  the  DMA  link  between  the  VAX  and  the  LSI  to  the 
user,  sets  graphic  controller  0  as  the  current  unit,  sets  the  text  font 
nuaber  to  zero,  and  disables  the  Inhibit -display  switch  (see  section 
4.2.4).  This  routine  oust  be  called  before  any  of  the  other  picture 
manipulating  routines. 

4.1. 1.2  Arguments 

There  are  two  arguments ,  both  of  which  are  optional.  However,  If  the 
second  argument  Is  specified,  then  the  first  must  also  be  Included. 

( 1 )  code 

Type :  integer 

Use:  This  argument  specifies  the  action  to  be  taken  if  the 
DMA  link  is  allocated  to  another  user,  resulting  in 
the  graphic  system  being  unavailable*  This  gives  a 
user  four  options  so  that  computer  time  spent  in  pic¬ 
ture  generation  is  not  subsequently  wasted  when  the 
picture  cannot  be  displayed  immediately.  The  values 
that  code  can  have,  and  the  subsequent  actions  are  as 
follows: 

0  -  dialogue  -  the  user  is  asked  whether  he 
wants  to  exit,  try  again,  or  be  told  who  is 
currently  using  the  graphic  system 

1  -  terminate  -  stop  the  program  if  the  graphic 

system  is  unavailable 

2  -  no  action  -  attempt  to  allocate  and  set  the 

returned  function  value  according  to  suc¬ 
cess  or  failure 

3  -  wait  -  keep  trying  to  allocate  at  1  minute 

Intervals  until  successful 

If  code  is  omitted,  or  specified  as  any  other  value, 
it  is  treated  as  having  been  specified  as  0. 

(2)  error— lia 
Type :  integer 

Use:  With  the  spot  positioning,  text  and  vector  drawing 
routines  (described  below  in  sections  4.4  and  4.5), 
an  attempt  nay  be  made  to  set  coordinates  outside  the 
512  x  512  pixels  of  the  picture.  Argument  error— lim 
is  used  to  specify  the  maximum  number  of  times  that 
such  an  error  will  be  reported  at  the  terminal.  If 

error— 11m.  is  specified  as  negative,  no  limit  will  be 
Imposed,  and  if  omitted,  a  default  value  of  5  is  used. 

4. 1.1. 3  Function  Return 

GRAPHIC— INIT  will  return  true  if  the  DMA  link  was  successfully  al¬ 
located,  and  false  if  it  was  not.  The  function  return  is  only  useful  when 
argument  code  is  specified  as  2  -  for  other  values  of  code,  pre -determined 
actions  are  executed  in  the  event  of  the  graphic  system  being  allocated  to 
another  user.  Bote  that  GRAPHIC- IN  IT  can  be  called  as  a  subroutine  rather 
than  as  a  function  when  code  ^  2. 


4.1.2  Subroutine  SCREEN-SELECT  (ittna-aMbtr ) 

4.1.2. 1  Purpose 

This  routine  change*  the  nuaber  of  the  current  graphic  controller.  All 
instructions  sent  by  graphics  routines  are  placed  into  the  buffer  of  the 
controller  selected  by  this  routine*  and  this  controller  remains  current 
until  altered  by  another  call  to  SC REEfL. SELECT  (or  SET-CONTROLLER*  see 
section  4.1.4).  As  mentioned  above*  controller  0  1s  initially  selected  by 
GRAPHIC_XKIT. 

4. 1.2.2  Arguments 
SCREEN_SELECT  has  one  argument: 

( 1 )  acreea-naaber 

Type :  Integer 

Use:  This  argument  is  the  number  of  the  controller  which 
is  to  become  the  current  controller'  1  should  be  0* 

1  or  2. 

4. 1.2.3  Errors 

A  fatal  error  results  if  SCREEN— SELECT  is  called  .t’  it  a  preceding 
call  to  GRAPMC.INIT,  or  if  it  is  called  with  an  argument  ..ose  value  is  not 
0,  1  or  2. 

4.1.3  Integer  Function  VIICB-SCRKEK  ) 

4. 1.3. 1  Purpose 

This  function  returns  to  the  user  the  number  of  the  current  controller. 

4. 1.3. 2  Arguments 

VH1CH— SCREEN  has  no  arguments. 

4.1.3. 3  Function  Return 

WHI CH_SCREEN  will  return  0*  1  or  2  according  to  irtiichever  is  the  current 
controller. 

4. 1.3.4  Errors 

A  fatal  error  results  if  WHICH—SCREEN  is  called  without  a  preceding  call 
to  CRAPHIGJWIT. 

4.1.4  Subroutine  SET-CONTROLLER (screem-ommberl, clear { , no-reset  ID 

4. 1.4.1  Purpose 

This  routine  changes  the  number  of  the  current  graphic  controller*  and 
then  initialises  the  controller’s  x  and  y  coordinates  to  zero*  sets  the 
memory  mask  to  enable  all  planes*  resets  the  scroll  offset*  enables  picture 
displaying  and  sets  the  colour  map  read  and  write  quadrants  to  zero.  The 
user  can  optionally  clear  the  screen,  and  suppress  this  initialisation. 

4. 1.4.2  Arguments 

SET-CONTROLLER  has  three  arguments,  the  last  two  being  optional: 

( 1 )  screen-number 

Type :  Integer 

Use:  This  argument  is  the  number  of  the  controller  which 
is  to  become  the  current  controller*  and  should  be  0* 
1  or  2. 


(2)  clear 

Type:  logical 

Uae :  This  argument  la  a  flag  to  indicate  whether  the  new 
current  controller  screen  should  be  cleared.  If 
clear  is  specified  as  true,  all  pixels  are  set  to 
colour  0  (usually  this  is  set  up  in  the  nap  as  black). 
If  clear  is  specified  as  false,  or  omitted,  no  such 
action  is  taken. 

(3)  no— reset 
Type :  logical 

Use:  This  argument  is  a  flag  to  indicate  whether  or  not  the 
above-nentloned  initialisation  should  be  suppressed. 
If  no_reaet  Is  specified  as  true,  the  initialisation 
Is  suppressed.  If  it  Is  specified  as  false,  or  omit¬ 
ted,  the  initialisation  is  performed. 

4. 1.4. 3  Errors 

A  fatal  error  results  if  SET— CONTROLLER  is  called  without  a  preceding 
call  to  GRAPHIG-INIT,  or  if  it  called  with  its  first  argument  outside  the 
range  of  0-2. 

4.1.5  Subroutine  GNAPHIC_FINISH( [clear )) 

4. 1.5. 1  hirpose 

This  routine  releases  the  DMA  link  between  the  VAX  and  the  LSI  making  it 
available  to  other  users.  If  any  spot  positioning  errors  were  detected, 
the  total  count  of  these  will  be  reported  at  the  useT*s  terminal.  After  a 
GRAPHIC-FINISH  call,  GRAPHIC-INIT  must  be  called  to  re-initiallse  the 
graphic  system  if  further  picture  processing  is  to  be  done. 

4.1.5. 2  Arguments 

GRAPHIC— FINISH  has  one  optional  argument: 

( 1 )  clear 

Type:  logical 

Use:  This  argument  is  a  flag  to  indicate  whether  or  not  the 
picture  on  the  current  screen  should  be  zeroed  before 
the  graphic  system  is  relinquished.  If  specified  as 
true,  all  pixels  are  set  to  colour  0.  If  clear  is 
specified  as  false,  or  is  omitted,  the  picture  is 
left  on  the  screen. 

4.1.5. 3  Errors 

A  fatal  error  results  if  GRAPHIC— FINISH  is  called  without  a  preceding 
call  to  GRAPHIC-INIT. 

4.2  Data  Transmission  Routines 

4.2.1  Subroutine  SEND— 0ATA( values, nuur-ralues) 

4.2. 1.1  Purpose 

This  routine  is  called  whenever  it  is  necessary  to  transmit  graphics  in¬ 
structions  to  the  current  controller.  Each  call  to  SEND-DATA  places  in¬ 
structions  into  a  buffer  reserved  in  the  VAX  for  that  controller.  When  this 
buffer  la  full,  its  contents  are  transmitted  via  the  DMA  link  to  a  cor¬ 
responding  buffer  in  the  host  LSI.  When  that  buffer  is  full,  the  LSI  trans¬ 
fers  its  contents  to  the  current  controller.  Alternatively,  transmission 
of  a  partially  filled  buffer  can  be  forced  by  calling  subroutine  DISPLAY 
(•ee  section  4.2.2).  Thus,  a  user  can  send  several  groups  of  instructions, 


and  have  transmission  of  these  to  the  current  controller  delayed  until  all 
groups  have  been  accuaulated. 

4.2. 1.2  Arguaents 

SEND— DATA  has  two  arguaents: 

(1)  values 

Type:  integer*2  array  or  logical*2  array  (note  the  "*2" 
specification) 

Use:  This  array  specifies  the  data  to  be  sent  to  the 
graphic  systea  host  LSI. 

(2)  nue-values 
Type :  Integer 

Use:  This  arguaent  specifies  the  number  of  words  in  the 
values  array. 

4. 2. 2. 3  Errors 

A  fatal  error  results  if  SEND— DATA  is  called  without  a  preceding  call  to 
GRAPHIC_INIT. 

4.2.2  Subreutiae  DISPLAY 

4. 2. 2.1  Purpose 

This  routine  transmits  to  the  current  controller  any  Instructions  which 
have  accuaulated  in  the  VAX  or  LSI  buffers  through  calls  to  SEND— DATA  (see 
section  4.2.1).  If  there  are  no  Instructions  in  either  buffer,  no  action  is 
taken. 

4. 2. 2. 2  Arguaents 
DISPLAY  has  no  arguments. 

4. 2. 2. 3  Errors 

A  fatal  error  results  if  DISPLAY  is  called  without  a  preceding  call  to 
GRAPHIC— INIT . 

4.2.3  Subroutine  FETCH_DATA( values , nua— values ) 

4.2.3. 1  Purpose 

This  routine  is  used  when  data  transmission  is  required  froa  the  graphic 
system's  host  LSI  to  the  VAX.  This  will  normally  arise  when  part  or  all  of 
the  picture  of  the  current  controller  is  to  be  read  back.  Note  that  the  LSI 
will  not  transalt  data  until  it  has  received  the  coaaand  to  do  so,  and  hence 
a  call  to  FETCH-DATA  aust  be  preceded  by  a  call  to  SEND-DATA  which  sends  s 
single  word  containing  a  negative  Integer  as  described  in  section  3.1. 
This  will  cause  the  host  LSI  to  start  transmission  of  pixel  data,  and 
FETCH-DATA  will  then  receive  this  data  and  store  the  pixels  in  pairs  as  16 
bit  (integer*2)  words. 

4.2.3. 2  Arguaents 

FETCH— DATA  has  two  arguments: 

(1)  values 

Type:  integer*2  array  or  logical*2  array  (note  the  "*2" 
specification ) 

Use:  This  array  receives  the  data  to  be  sent  to  the  VAX  by 
the  graphic  unit  host  LSI. 


(2)  nan— values 

Type :  Integer 

Use:  This  srguaent  specifies  the  number  of  words  to  be 
stored  in  the  values  srrsy.  This  will  correspond  to 
the  nuaber  of  pixel  pairs  to  be  read  froa  the  graphic 
controller’s  aeaory* 

4.2.3. 3  Errors 

A  fatal  error  results  if  FETCH-DATA  is  called  without  a  preceding  call 
to  GRAPHIC— INIT. 

4.2.4  Subrout lac  INHIBIT 

4.2.4. 1  hirpose 

Each  transalsslon  of  Instructions  froa  the  VAX  to  the  current  controller 
incurs  an  overhead  in  VAX  processing.  This  overhead  does  not  depend  upon 
the  nuaber  of  Instructions  being  sent,  and  hence  it  is  wore  efficient  to 
send  a  single  large  block  of  instructions  rather  than  several  smaller 

blocks.  Several  routines  in  the  FL1SGRAPH  package  (e.g.  SET-COLOUR  (sec¬ 
tion  4.3.3)  or  MOVE  (section  4.4.4))  Involve  the  transalsslon  of  a  very 
saall  nuaber  of  Instructions,  and  these  are  noraally  sent  as  they  are 
generated  by  a  call  to  DISPLAY  within  each  routine.  This  has  an  isnediate 
effect  upon  the  picture  on  the  current  screen,  at  soae  cost  in  efficiency. 
If  it  is  not  necessary  to  observe  the  result  of  each  routine  as  it  is  cal¬ 
led,  efficiency  can  be  Improved  by  a  call  to  INHIBIT.  This  sets  a  flag 
within  the  FLISGRAPH  package  so  that  these  small  groups  of  Instructions  sre 
not  transaltted  until  the  user  explicitly  requests  it  with  a  call  to 
DISPLAY. 

4. 2. 4. 2  Arguments 
INHIBIT  has  no  arguments. 

4.2.  5  Subroutine  UN-IMHIBIT 

4.2.5. 1  Purpose 

This  routine  disables  the  inhibit -display  switch  within  the  FLISGRAPH 
package,  so  that  all  routines  send  their  grsphics  instructions  as  they  are 
generated.  This  routine  has  the  opposite  effect  of  INHIBIT  (section 
4.2.4). 

4.2.5. 2  Arguaents 

UN— INHIBIT  has  no  arguaents. 

4.3  Raster  Graphic  Controller  Operation  Routines 

4. 3. 1  General 

These  routines  lapleaent  directly  several  of  the  graphic  controller's 
Instructions  (the  full  instruction  set  appears  in  Apoendix  A).  Note  that 
all  these  routines  call  SEND- DATA  and  hence  a  fatal  error  will  result  if 
there  has  been  no  previous  call  to  GRAPHIC-INIT. 

4.3.2  Subroutine  SET-COLOUR (colour ) 

4.3. 2.1  Purpose 

This  routine  sends  the  appropriate  Instruction  to  the  current  graphic 
controller  to  change  the  value  in  the  controller's  colour  code  register. 
This  colour  is  then  used  in  all  future  Instructions  which  write  the  con¬ 
troller  aeaory  until  changed  again. 


4. 3. 2. 2  Argument* 

SET-jCOLOUR  has  one  argument : 

(1)  colour 

Type :  Integer 

Use:  This  argument  specifies  the  value  of  the  new  colour, 
and  should  lie  between  0  and  255  inclusive.  If 
colour  is  outside  this  range,  the  least  significant 
eight  bits  are  used. 

4.3.3  Subroutine  SET-MASK (mask) 

4.3.3. 1  Purpose 

This  routine  sends  the  appropriate  instruction  to  the  current  graphic 
controller  to  change  the  value  in  the  controller's  aask  register.  This 
register  is  used  to  determine  which  memory  planes  can  be  written.  Setting 
one  of  the  mask  bits  to  zero  prevents  modification  of  the  corresponding  bit 
plane,  and  results  in  a  sub-set  of  the  colour  map  being  used. 

4.3.3. 2  Arguments 
SET-MASK  has  one  argument : 

(1)  mask 

Type:  Integer 

Use:  This  argument  specifies  the  value  of  the  new  mask, 
and  should  lie  between  0  and  255  inclusive.  If  mask 
Is  outside  this  range,  the  least  significant  eight 
bits  are  used  to  determine  which  memory  planes  are 
write-enabled. 

4.3.4  Subroutine  SET— QUADIAllT(dl8play-quadtwrite-quad) 

4. 3. 4.1  Purpose 

This  routine  sends  the  appropriate  instructions  to  the  current  graphic 
controller  to  change  the  display  and  write  colour  map  quadrants.  Selection 
of  a  display  quadrant  determines  which  of  the  four  stored  colour  maps  (see 
section  2.0)  will  be  used,  while  selection  of  a  write  quadrant  determines 
which  of  the  four  maps  will  be  altered  by  future  "load-colour-map" 
instructions. 

4. 3. 4. 2  Arguments 
SET-QUADRANT  has  two  arguments: 

( 1 )  display— quad 
Type :  Integer 

Use:  This  argument  specifies  the  new  display  quadrant  num¬ 
ber,  and  should  lie  between  0  and  3  inclusive.  If 
display— quad  is  outside  this  range,  no  action  is 
taken,  so  that  this  routine  can  be  used  to  select 
write  quadrant  only. 

(2)  write— quad 
Type:  Integer 

Use:  This  argument  specifies  the  new  write  quadrant  num¬ 
ber,  and  should  lie  between  0  and  3  inclusive.  If 
write— quad  is  outside  this  range,  no  action  is 
taken,  so  that  this  routine  can  be  used  to  select 
display  quadrant  only. 


4.3.4  Subroutine  SET— SCREEN (colour) 

4. 3.4. 1  Purpose 

This  routine  sends  the  Instruction  to  the  current  graphic  controller  to 
colour  all  pixels  of  the  screen  in  a  particular  value.  Since  nost  colour 
naps  are  set  up  with  colour  0  being  black,  this  routine  can  be  used  to  clear 
the  screen  by  calling  it  with  an  argument  of  0. 

4.3. 5.2  Arguments 

SET-SCREEN  has  one  argument : 

( 1 )  colour 

Type:  Integer 

Use:  This  argument  specifies  the  value  of  the  colour  to 
which  all  pixels  will  be  set,  and  should  lie  between  0 
and  255  Inclusive.  If  colour  is  outside  this  range, 
the  least  significant  eight  bits  are  used. 

4.3.6  Subroutine  SCROLL(x,y) 

4.3.6. 1  Purpose 

This  routine  sends  the  appropriate  instruction  to  the  current  graphic 
controller  to  scroll  the  picture  by  one  pixel  or  to  reset  the  scroll 
offset . 

4. 3. 6. 2  Arguments 

SCROLL  has  two  arguments: 

(1)  x 

Type :  Integer 

Use:  This  argument  defines  the  scroll  to  be  performed  in 
the  horizontal  direction.  If  positive,  a  +X  scroll 
is  effected,  if  negative,  a  -X  scroll  is  effected.  If 
zero,  no  X  scroll  takes  place. 

(2)  T 

Type:  Integer 

Use:  This  argument  defines  the  scroll  to  be  nerformed  in 
the  vertical  direction.  If  positive,  a  +Y  scroll  is 
effected,  if  negative,  a  -Y  scroll  is  effected.  If 
zero,  no  Y  scroll  takes  place.  Note  that  if  x  and  y 
are  both  zero,  a  scroll  reset  is  effected. 

4.3.7  Subroutine  LOADL.COLOURS ( count , addresses, red, green, blue) 

4.3. 7.1  Purpose 

This  routine  sends  Instructions  to  the  current  graphic  controller  to 
load  any  or  all  of  the  elements  of  the  colour  map  with  a  set  of  red,  green 
and  blue  components.  The  quadrant  affected  is  the  one  selected  by  the  nost 
recent  write  quadrant  instruction. 

4.3. 7.2  Arguments 

LOAD-COLOURS  has  five  arguments: 

( 1 )  count 

Type :  Integer 

Use:  This  argument  specifies  the  number  of  elements  of  the 
colour  nap  that  are  to  be  changed. 


(2)  addresses 

Type:  integer  array 

Use:  This  array  of  couat  elements  specifies  the  addresses 
in  the  colour  up  which  are  to  be  changed. 

(3)  red 

Type:  Integer  array 

Use:  This  array  of  eoumt  elements  specifies  the  new 
values  of  the  red  components  of  the  colours  in  the 
map.  The  red  values  should  lie  between  0  and  127 
inclusive.  If  any  value  is  outside  this  range,  the 
least  significant  seven  bits  are  used. 

(4)  green 

Type:  Integer  array 

Use:  This  array  of  coamt  elements  specifies  the  new 

values  of  the  green  components  of  the  colours  in  the 
map.  The  green  values  should  lie  between  0  and  255 
Inclusive.  If  any  value  is  outside  this  range,  the 
least  significant  eight  bits  are  used. 

(5)  blue 

Type:  integer  array 

Use:  This  array  of  count  elements  specifies  the  new 

values  of  the  blue  components  of  the  colours  in  the 
map.  The  blue  values  should  lie  between  0  and  63 
inclusive.  If  any  value  is  outside  this  range,  the 
least  significant  six  bits  are  used. 

4.3.8  Subroutine  LOAtt-NAP^f ILK (quadrant , filename [ .details ) ) 

4.3.8. 1  Purpose 

This  routine  loads  a  colour  map  with  a  precomputed  set  of  values  stored 
in  a  formatted  binary  file.  It  is  assumed  that  colour  amps  are  generated 
from  a  set  of  hue,  saturation  and  Intensity  values  since  most  observers  are 
better  able  to  identify  colours  by  these  rather  than  by  their  primary 
colour  components.  However,  the  hue,  saturation  and  Intensity  values  must 
be  converted  to  red,  green  and  blue  components  for  loading  into  the  graphic 
controller,  and  hence  the  format  for  the  colour  nap  file  includes  infor- 
nation  describing  the  generation  in  addition  to  the  actual  colours.  Since 
the  saturation  of  a  whole  scene  is  more  generally  dependent  on  external 
conditions  (e.g.  fog)  than  on  entitles  within  the  scene,  it  is  not  un¬ 
reasonable  to  define  as  constant  the  saturation  for  a  colour  nap.  The 
remainder  of  the  map  can  be  specified  by  choosing  the  number  of  intensity 
levels  for  each  colour,  say  N,  which  then  allows  256/N  hues.  This 
definition  can  be  pictured  by  treating  colour  space  as  a  pair  of  cones 
joined  base-to-base ,  with  Intensity  varying  along  the  axis,  saturation 
increasing  radially,  and  with  hue  being  defined  by  an  angular  displacement 
around  the  cone.  Generally,  red  is  defined  to  be  at  0  degrees,  green  at  120 
degrees  and  blue  at  240  degrees,  with  varying  hues  in  between.  As  intensity 
becomes  extreme,  the  colour  is  perceived  as  nearly  white  or  nearly  black, 
with  little  hue  and  saturation  components. 

A  further  complication  is  that  the  eve  has  a  non-linear  perception  of 
Intensity,  so  it  is  necessary  to  introduce  a  correction  factor  (the  "gama" 
correction)  to  allow  for  this.  The  gama  factors  (one  for  each  primary 
colour)  used  in  producing  the  map  are  also  stored  in  the  map  file. 

The  map  file  must  be  a  FORTRAN  binary  file  comprising  one  record  set  out 
as  follows: 


o  ■  number  of  colours  to  be  set  up  integer*4 

■ap  addresses  (between  0  and  255)  logical*!  array(l:n) 

red  components  (between  0  and  127)  loglcal*l  array(ltn) 

green  components  (between  0  and  255)  logical*l  array(l:n) 

blue  components  (between  0  and  63)  logical*!  array(l:n) 

angular  separation  between  hues  (degrees)  real** 

saturation  (between  0  and  1)  real*4 

number  of  Intensity  levels  real *4 

red  gamaa  correction  value  real*4 

green  gamma  correction  value  real *4 

blue  gamma  correction  value  real*4 

4. 3. 8. 2  Arguments 

LOADlMAP-FILE  has  three  arguments,  the  third  being  optional: 

( 1 )  qmadrant 

Type:  Integer 

Use:  This  argument  specifies  the  quadrant  into  which  the 
colour  map  is  to  be  loaded,  and  should  be  between  0 
and  3  inclusive.  This  quadrant  becomes  the  current 
one  for  all  future  instructions.  If  quadrant  is  out 
of  range,  no  quadrant  change  takes  place  and  the  cur¬ 
rent  quadrant  is  used. 

(2)  filename 

Type:  character  string 

Use:  This  argument  specifies  the  name  of  the  file  con¬ 
taining  the  colour  map  to  be  loaded.  It  is  assumed 
that  this  file  exists  in  the  directory  defined  by  the 
logical  name  NAP:.  If  this  file  does  not  exist  in  the 
MAP:  directory,  the  user's  directory  will  be  searched 
for  the  file. 

(3)  details 

Type:  real  array  of  6  elements 

Use:  If  this  argument  is  specified,  the  last  6  entries  in 
the  file  of  the  colour  nap  will  be  returned  as  the  6 
array  elements. 

4.3.8. 3  Errors 

A  fatal  error  will  result  if  the  file  does  not  exist  in  the  MAP:  direc¬ 
tory  or  in  the  user's  directory,  or  if  the  file  format  does  not  natch  thst 
described  above. 

4.4  Spot  Positioning  and  factor  Drawing  Eootlnes 
4.4.1  General 

The  routines  in  this  section  keep  track  of  the  controller’s  x  and  y  coor¬ 
dinate  values  ("spot  position")  and  each  call  checks  whether  or  not  the 
requested  move  will  result  in  the  spot  position  being  off  screen.  If  this 
is  the  case,  no  action  is  taken,  but  the  number  of  spot  positioning  errors 
is  incremented.  If  the  accumulated  number  of  off-screen  errors  is  less 

than  the  limit  set  up  in  the  call  to  GRAPHIC— INIT  (see  section  4.1.1),  a 
warning  message  will  be  given.  The  total  number  of  spot  positioning  errors 
will  always  be  reported  to  the  user  when  GRAPHIC— FINISH  is  called  (see  sec¬ 
tion  4.1.5).  Note  that  the  origin  is  the  bottom  left-hand  corner  of  the 
screen. 


Not*  also  that  these  routines  call  SEND-DATA  and  hence  a  fatal  error 
will  result  If  there  has  been  no  previous  call  to  GRAPHIC— INIT. 

4.4.2  Subrout lac  DiAll.SPOT(a,y | , colour]) 

4.4. 2.1  Purpose 

This  routine  draws  a  spot  at  the  point  whose  coordinates  are  specified 
In  the  call,  provided  that  that  point  Is  on  the  screen.  The  spot  is  drawn  by 
first  setting  the  current  controller  colour,  then  setting  its  x  and  y 
position  valuas  and  writing  that  pixel. 

4. 4. 2. 2  Arguments 

DRAW— SPOT  has  three  arguaents,  the  third  being  optional: 

O)  * 

Type :  integer 

Use:  This  argument  specifies  the  X-coordlnate  of  the  spot 
to  be  drawn,  and  should  be  between  0  and  511 

inclusive. 

(2)  y 

Type :  integer 

Use:  This  arguaent  specifies  the  Y-coordinate  of  the  spot 
to  be  drawn,  and  should  be  between  0  and  511 

inclusive. 

(3)  colour 

Type :  integer 

Use:  This  arguaent  specifies  the  colour  in  which  the  spot 
is  to  be  drawn,  and  should  be  between  0  and  255 

inclusive.  If  colour  is  Quitted,  the  current  colour 
is  used;  if  specified,  it  replaces  the  current 

colour.  If  colour  is  out  of  range,  the  least  sig¬ 
nificant  eight  bits  are  used. 

4.4.3  Subroutine  DBAU-SPOT-REL(x,y[» colour)) 

This  routine  does  the  same  as  the  DRAW-SPOT  routine  but  the  x  and  y  ar¬ 
guaents  are  interpreted  as  coordinates  relative  to  the  current  spot 
position  rather  than  as  absolute  coordinates. 

4.4.4  Subroutine  MOVE(x,y) 

4. 4. 4.1  Purpose 

This  routine  sets  the  current  controller's  x  and  y  position  values  to 
those  specified  in  the  call,  provided  that  the  desired  position  is  on  the 
screen.  Note  that  it  does  not  draw  anything  on  the  screen.  It  is  used  for 
positioning  vectors  or  text. 

4. 4. 4. 2  Arguaents 

HOVE  has  two  arguments: 

(1)  x 

Type:  integer 

Use:  This  arguaent  specifies  the  X-coordinate  of  the  new 
spot  position,  and  should  be  between  0  and  511 
inclusive. 

(2)  y 

Type:  integer 

Use:  This  argument  specifies  the  Y-coordinate  of  the  new 


spot  position,  and  should  be  between  0  and  511 
Inclusive. 

4.4.5  Subroutine  REL_IIOVE(x,y  ) 

This  routine  does  the  ssae  as  the  HOVE  routine  but  the  x  and  y  arguments 
are  Interpreted  as  coordinates  relative  to  the  current  spot  position  rather 
than  as  absolute  coordinates. 

4.4.6  Subroutine  VECTOR (x,yf, colour)) 

4.4.6. 1  hirpose 

This  routine  checks  that  the  point  (x,y)  is  on  the  screen,  and  if  ao, 
noves  the  spot  to  that  point  and  draws  the  vector  between  the  last  position 
of  the  spot  and  (x,y)  in  the  specified  colour. 

4. 4. 6. 2  Arguments 

VECTOR  has  three  argunents,  the  third  being  optional: 

(1)  x 

Type :  Integer 

Use:  This  argument  specifies  the  X-coordlnate  of  the  end 
point  of  the  vector,  and  should  be  between  0  and  511 
inclusive. 

(2)  y 

Type:  Integer 

Use:  This  argument  specifies  the  Y-coordlnate  of  the  end 
point  of  the  vector,  and  should  be  between  0  and  511 
Inclusive. 

(3)  colour 

Type :  Integer 

Use:  This  argument  specifies  the  colour  in  which  the  vec- 
tor  is  to  be  drawn,  and  is  specified  in  exactly  the 
same  manner  as  the  colour  argument  in  DRAW-SPOT. 

4.4.7  Subroutine  REL-VECTOR(x,y ( , colour)) 

This  routine  does  the  same  as  the  VECTOR  routine  but  the  x  and  y  ar¬ 
gunents  are  Interpreted  as  coordinates  relative  to  the  current  spot 
position  rather  than  as  absolute  coordinates. 

4.4.8  Subroutine  R- VECTOR ( x—emd ( , colour ) ) 

4.4.8. 1  Purpose 

This  routine  is  a  direct  implementation  of  the  graphic  controller's 
incremental  move  instruction,  and  draws  a  horizontal  vector  from  ONE  PIXEL 
AFTER  the  current  apot  position  (in  the  appropriate  direction)  to  the  end 
pixel,  specified  in  the  call,  provided  that  the  end  point  is  on  the  screen. 
A  call  to  this  routine  would  usually  be  preceded  by  a  call  to  DRAW-SPOT ; 
these  routines  used  in  this  way  provide  the  fastest  way  of  drawing  horizon¬ 
tal  vectors. 

4.4.8. 2  Arguments 

R-VECTOR  has  two  arguments,  the  second  being  optional: 

(1)  s— end 

Type:  Integer 

Use:  This  argument  specifies  the  X-coordinate  of  the  end 
point  of  the  vector,  and  should  be  between  0  and  5)1 
inclusive. 


(2)  colour 

Typo :  Integer 

Use:  This  erguoent  specifies  the  colour  in  which  the  vec- 
tor  is  to  be  drawn,  and  is  specified  in  exactly  the 
same  manner  as  the  colour  argument  in  DRAW-SPOT, 

4.4.9  Subroutine  W-?ECTOI(y-«nd ( .colour J ) 

This  routine  draws  a  vertical  vector  in  exactly  the  same  Banner  as 
H— VECTOR  draws  a  horizontal  vector.  Combined  with  DRAW— SPOT,  it  is  the 
fastest  way  to  draw  vertical  vectors. 

4.4.9. 1  Arguments 

V— VECTOR  has  two  arguments,  the  second  being  optional: 

( 1 )  y— end 

Type:  Integer 

Use:  This  argument  specifies  the  Y-coordinate  of  the  end 
point  of  the  vector,  and  should  be  between  0  and  511 
Inclusive. 

(2)  colour 

Type:  Integer 

Use:  This  argument  specifies  the  colour  in  which  the  vec- 
tor  is  to  be  drawn,  and  is  specified  in  exactly  the 
same  manner  as  the  colour  argument  in  DRAW-SPOT. 

4.4.10  Subroutine  LOCATE-POIHT 

(crons— colour ,x ,y [ .xstart ( .yntart ))) 

4.4.10.1  Purpose 

This  routine  enables  a  user  to  locate  Interactively  a  point  on  the  cur¬ 
rent  screen.  The  user  is  asked  to  specify  moves  to  position  a  set  of 
"cross-hairs"  about  the  screen  until  it  is  at  the  desired  point.  Moves  are 
specified  interactively  as  Un,  Dn,  Ln  or  Rn  for  n  pixel-steps  upwards,  dow¬ 
nwards,  left  or  right.  Once  the  desired  point  is  reached,  the  user 
specifies  a  zero  rather  than  a  move  and  the  spot  coordinates  are  returned 
ln  the  subroutine  argument  list. 

4.4.10.1  Argunents 

LOCATE— POINT  has  five  argunents,  the  last  two  being  optional: 

(  1 )  cross— colour 

Type:  integer 

Use:  This  argument  specifies  the  colour  of  the  "cross¬ 
hairs",  and  should  lie  between  0  and  255  inclusive. 
If  cross— colour  is  outside  this  range,  the  least 
significant  eight  bits  are  used. 

(2)  x 

Type:  integer 

Use:  This  argument  is  an  output  parameter  and  contains  the 
x-coordlnate  of  the  located  point. 

O)  J 

Type:  integer 

Use:  This  argument  is  an  output  parameter  and  contains  the 
y-coordlnate  of  the  located  point. 


(4)  xstart 

Type :  integer 

Use:  This  argument  specifies  the  intial  x-coordlnate  of 
the  centre  of  the  "cross-hairs".  If  omitted*  a  value 
of  2S6  (screen  centre)  is  used. 

(5)  yatart 

Type:  integer 

Use:  This  argument  specifies  the  intial  y-coordinate  of 
the  centre  of  the  "cross-hairs".  If  omitted*  a  value 
of  2S6  (screen  centre)  is  used. 

4.5  Test  Routines 

4.5.1  General 

The  routines  in  this  section  provide  a  text  drawing  caoabllity.  The 
FLISGRAFH  package  contains  two  text  fonts*  with  font  0  being  a  set  of 
characters  9  pixels  high  and  5  pixels  wide,  and  font  1  being  an  11  pixel 
high  by  6  pixel  wide  set.  For  text  strings*  characters  are  dram  with  a 
spacing  of  two  pixels.  All  128  ASCII  codes  are  Interpreted.  Carriage 
return,  linefeed,  backspace  and  tab  are  Interpreted  as  would  be  expected* 
whereas  all  other  control  codes  (in  the  range  0  to  31)  are  represented  by 
drawing*  enclosed  in  a  rectangle*  the  character  whose  ASCII  code  is  the 
control  code  plus  64. 

4.5.2  Subroutine  FORT  (font-lumber) 

4. 5. 2.1  Purpose 

This  routine  sets  an  internal  value  in  the  FLISGRAFH  package  to  deter¬ 
mine  which  font  is  to  be  used  in  future  character  drawing  routines.  Note 
that  a  call  to  routine  GRAPHIC-INIT  always  resets  the  font  number  to  0. 

4. 5. 2. 2  Arguments 

FONT  has  one  argument : 

( 1 )  font-number 
Type :  Integer 

Use:  This  argument  specifies  the  font  which  will  be  used 
for  all  future  character  drawing*  and  should  be 
either  0(9x5  set)  or  1  (11  x  6)  set. 

4. 5. 2. 3  Errors 

A  warning  is  given  if  a  font  number  other  than  0  or  1  is  specified  as  the 
argument.  In  this  case,  the  font  number  is  unaltered. 

4.5.3  Subroutine  DRAlL.CBAl(ch,orlentatlon*success) 

4.5.3. 1  Purpose 

DRAW^CHAR  is  the  basic  routine  for  drawing  characters,  and  is  called  by 
all  other  text  routines.  It  checks  that  the  character  will  fit  on  the 
screen,  and  if  it  will,  the  character  is  dram  in  the  current  colour,  with 
its  lower  left  corner  at  the  current  soot  position.  The  spot  position  is 
then  updated  to  the  lower  left  corner  of  the  next  character  space.  The  text 
font  used  is  that  specified  in  the  most  recent  call  to  routine  FONT  (or  0  if 
FONT  has  not  been  called  explicitly). 

4.5.3. 2  Arguments 

DRAW— CHAR  has  three  arguments: 


(1)  eh 

Type:  character* 1 

Uae:  This  argument  specif lea  the  character  to  be  drawn. 

(2)  orient at loo 
Type :  Integer 

Use:  This  argument  specifies  the  orientation  at  which  the 
character  is  to  be  drawn,  and  should  be  between  0  and 
3  inclusive.  If  orientation  is  outside  this  range, 
the  least  significant  2  bits  are  used.  The  value  of 
orientation  is  Interpreted  as  follows: 

0:  The  character  is  drawn  without  rotation. 

1:  The  character  is  rotated  90  degrees 

counter-clockwise  before  it  is  drawn. 

2:  The  character  is  rotated  180  degrees 

counter-clockwise  before  it  is  drawn  (l.e. 
it  appears  inverted). 

3:  The  character  is  rotated  270  degrees 

counter-clockwise  before  it  is  drawn. 


(3)  success 

Type :  logical 

Use:  Hils  argument  is  set  by  DRAW-CHAR  and  indicates 
whether  or  not  the  character  was  drawn  successfully. 
Failure  occurs  when  the  character  will  not  fit  com¬ 
pletely  on  the  screen. 

4.5. 3. 3  Errors 

If  DRAW— CHAR  detects  that  the  character  will  not  fit  on  the  screen,  it 
takes  no  action  other  than  to  Increment  the  number  of  spot  positioning  er¬ 
rors.  If  the  accumulated  number  of  off-screen  errors  is  less  than  the  limit 
set  up  in  the  call  to  GRAFHIC.INIT  (see  section  4.1.1),  a  warning  message 
will  be  given. 

This  routine  calls  SENDi-DATA  and  hence  a  fatal  error  will  result  if 
there  has  been  no  previous  call  to  GRAPHIC—INIT. 

4.5.4  Subroutine  DKAU-TXXT 

(string l ,nchars ( , orientation  f , colour  H ) ) 

4. 5.4.1  Purpose 

DRAW-TEXT  calls  subroutine  DRAW-CHAR  to  draw  each  of  the  characters  in  a 
string  (in  the  current  font)  onto  the  graphic  screen,  with  the  first 
character’s  lower  left  corner  at  the  current  spot  oosltlon.  If  the  entire 
string  will  not  fit  on  the  screen,  only  those  characters  that  fit  com¬ 
pletely  will  be  drawn.  DRAW— TEXT  updates  the  soot  position  to  the  lower 
left  corner  of  the  next  character  space. 

4. 5. 4. 2  Arguments 

DRAW— TEXT  has  four  arguments,  with  the  last  three  being  optional. 
However,  if  a  particular  optional  argument  is  specified,  then  all  arguments 
to  its  left  in  the  calling  sequence  oust  also  be  specified. 


m*  m 


( 1 )  string 

Type:  character  string 

Use:  This  arguaent  specifies  the  string  of  characters  to 
be  drawn* 

(2)  nchars 

Type:  integer 

Use:  This  argument  specifies  the  number  of  characters  in 
the  string  to  be  drawn.  If  nchars  is  ositted,  or  is 
specified  as  negative,  zero,  or  greater  than  the 
length  of  the  string,  then  the  entire  string  is 
drawn. 

(3)  orientation 

Type:  Integer 

Use:  This  arguaent  specifies  the  orientation  at  which  the 
characters  in  the  string  are  to  be  drawn,  and  is 
specified  in  exactly  the  same  nanner  as  the  orien¬ 
tation  argument  in  DRAW_CHAR.  If  orientation  is 
omitted,  then  a  value  of  0  (i.e.  no  rotation)  is 
used. 

(4)  colour 

Type :  Integer 

Use:  This  arguaent  specifies  the  colour  in  which  the 
string  is  to  be  drawn,  and  should  be  between  0  and  255 
Inclusive.  If  colour  is  omitted,  the  current  colour 
is  used;  if  specified,  it  replaces  the  current 
colour.  If  colour  is  out  of  range,  the  least  sig¬ 
nificant  eight  bits  are  used. 

4, 5. 4. 3  Errors 

Since  DRAW-TEXT  uses  subroutine  DRAW-CHAR,  it  will  be  subject  to  any  er¬ 
rors  detected  by  DRAW.CHAR. 

4.5.5  Subroutine  BIG-£HAl(ch, success) 

4.5. 5.1  Purpose 

BIG-CHAR  is  an  entry  point  in  subroutine  DRAW-CHAR  and  draws  double- 
sised  characters  (in  the  current  font)  by  drawing  each  pixel  in  the  basic 
character  as  a  2  x  2  square  of  pixels,  provided  that  the  character  will  fit 
conpletely  on  the  screen.  The  chsracter  is  drawn  in  the  current  colour, 
with  its  lower  left  corner  at  the  current  spot  position.  The  spot  position 
is  then  updated  to  the  lower  left  corner  of  the  next  character  space.  This 
routine  does  not  allow  characters  to  be  rotated,  and  draws  all  control 
characters  as  spaces. 

4.5. 5.2  Arguments 

BIG-CHAR  has  two  arguments: 

(1)  eb 

Type:  character*! 

Use:  This  argument  specifies  the  character  to  be  drawn. 

(2)  success 

Type:  logical 

Use:  This  arguaent  is  set  by  BIG-CHAR  and  indicates 
whether  or  not  the  character  was  drat  -  successfully. 
Failure  occurs  when  the  character  -?il *  not  fit  com¬ 
pletely  on  the  screen. 


4.5.5. 3  Errors 

BIG-CHAR  detects  the  seme  errors  thst  DRAW-CHAR  detects,  and  responds  to 
then  in  the  saae  manner. 

4.5.6  Subroutine  BIG— TEXT( string f,ncharaf, col our))) 

4.5.6. 1  Purpose 

BIG— TEXT  calls  subroutine  BIG-CHAR  to  drav  each  of  the  characters  in  a 
string  at  double  size  (in  the  current  font),  with  the  first  character’s 
lower  left  corner  at  the  current  spot  position.  If  the  entire  string  will 
not  fit  on  the  screen,  only  those  characters  that  fit  completely  will  be 
drawn.  BIG-TEXT  updates  the  spot  position  to  the  lower  left  corner  of  the 
next  character  space. 

4. 5. 6. 2  Arguments 

BIG— TEXT  has  three  arguments,  with  the  last  two  being  optional. 
However,  if  the  third  argument  is  to  be  specified,  then  the  second  must 
also  be  specified. 

(1)  string 

Type:  character  string 

Use:  This  argument  specifies  the  string  of  characters  to 
be  drawn. 

(2)  nchars 

Type :  Integer 

Use:  This  argument  specifies  the  number  of  characters  in 
the  string  to  be  drawn,  and  is  interpreted  in  exactly 
the  sane  manner  as  the  nchars  argument  in  routine 
DRAW-TEXT. 

(3)  colour 

Type:  Integer 

Use:  This  argument  specifies  the  colour  in  which  the 
string  is  to  be  drawn,  and  is  interpreted  in  exactly 
the  same  manner  as  the  colour  argument  in  routine 
DRAW-TEXT. 

4. 5.6. 3  Errors 

Since  BIG-TEXT  uses  subroutine  BIG-CHAR,  it  will  be  subject  to  any  er¬ 
rors  detected  by  BIG-CHAR. 

4.6  Picture  Transmission  Routines 

4.6.1  Subroutine  DIAWPIC(pieture , left , right , bottom, top) 

4.6. 1.1  Purpose 

This  routine  transmits  a  picture  by  copying  an  array  from  VAX  memory 
into  the  current  graphic  controller’s  memory.  The  array  represents  a  rec¬ 
tangular  section  of  the  screen,  and  contains  one  byte  for  each  pixel  to  be 
coloured.  DRAWPIC  sets  up  the  pixel  colour  information  as  a  sequence  of 
dump  mode  restore  instructions  which  are  transmitted  to  the  graphic  con¬ 
troller  with  SEND— DATA. 

4.6. 1.2  Arguments 

DRAWPIC  has  five  arguments: 

(1)  picture 

Type:  logical *1  array 

Use:  This  array  specifies  the  colour  of  each  pixel  to  he 


changed.  Note  that  this  array  Bust  be  dlmeneloned 
properly  -  Its  declaration  must  be  of  the  for* 


logical*l  picture(Nl :N2,M1:M2) 

In  general,  Nl-left,  N2-right ,  Ml -hot to*,  M2«top 
which  are  the  other  argunenta  to  DRAWP1C.  Ifowever, 
it  la  only  necessary  that  the  site  and  shape  of  the 
rectangle  as  specified  In  the  dlnensions  natch  exact¬ 
ly  the  size  and  shape  as  specified  by  the  other  ar- 
guaents,  i.e.,  N2-N 1 -right -left ,  and  M2-Ml-top- 
botto*.  The  effect  of  varying  Nl,  N2,  Ml,  M2  fro* 
left,  right,  botto*,  top  respectively  is  to  tran¬ 
slate  the  picture  before  it  Is  drawn  on  the  screen. 

(2)  left 

(3)  right 

(4)  botto* 

(5)  top 

Type:  integer 

Use:  These  arguaents  specify  the  Units  of  the  rectangle 
to  be  drawn,  and  have  a  close  correlation  with  the 
dlnensions  of  the  picture  array  as  described  above. 

4.6. 1.3  Errors 

This  routine  calls  SEND_DATA  and  hence  a  fatal  error  will  result  if 
there  has  been  no  previous  call  to  GRAPHIC-INIT. 

4.6.2  Subroutine  READ1ACK 

(picture,*— dimension, left .right , botto*, top) 

4. 6. 2.1  Purpose 

This  routine  copies  a  rectangular  section  from  the  current  graphic  con¬ 
troller’s  memory  Into  an  array  In  VAX  memory,  which  contains  one  byte  for 
each  pixel  to  be  read  back.  READBACK  obtains  the  information  by  commanding 
the  LSI  program  RJRLS1  to  send  a  sequence  of  dump  node  save  Instructions  to 
the  graphic  controller.  The  VAX  then  fetches  the  pixel  infornation  with 
FETCH-DATA . 

4. 6. 2. 2  Arguments 

READBACK  has  six  arguments: 

(1)  picture 

Type:  logical *1  array 

Use:  This  array  receives  the  pixel  data,  and  hence  must  be 
dimensioned  large  enough  to  have  Cat  least)  one 
element  for  each  pixel  to  be  read.  That  is,  its  total 
length  must  not  be  less  than 

( right -lef t+1 )*(  bot to*_top+l ). 

(2)  x— dimension 

Type:  integer 

Use:  This  argument  specifies  the  actual  length  of  a  row  of 
the  picture  as  dimensioned  in  the  calling  program. 
For  example,  if  it  is  required  to  read  hack  that  rec¬ 
tangle  of  the  picture  bounded  by  (0,0),  (0,20), 

(10,20)  and  (10,0)  into  an  array  defined  similarly, 
the  following  code  could  be  used: 


loglcal*l  picture(0: 10,0: 20) 
call  readback(picture,ll,0, 10,0,20) 


On  the  other  hand,  if  it  la  required  to  read  that  sane 
rectangle  into  a  full  picture  array,  the  following 
code  could  be  used: 

logical*!  picture(0: 511 ,0: 511 ) 
call  readback(plcture,512,0, 10,0,20) 

(3)  left 

<*)  right 

(5)  bottoa 

(6)  top 

Type:  integer 

Use:  These  arguments  specify  the  limits  of  the  rectangle 
to  be  read  back.  In  the  above  example,  left-0, 
right-10,  bottom-0  and  top-20. 

4. 6. 2. 3  Errors 

This  routine  calls  FETCH— DATA  and  hence  a  fatal  error  will  result  if 
there  has  been  no  previous  call  to  GRAPHIC— INIT . 

4.6.3  Subroutine  DRAW— B0X(lef t , right , bottom, top, (colour ] ) 

4.6. 3.1  Purpose 

This  routine  draws  a  coloured  rectangle  on  the  current  screen  in  a 
specified  colour. 

4.6. 3.2  Arguments 

DRAW— BOX  has  five  arguments,  the  last  one  being  optional: 

(1)  left 

(2)  right 

(3)  bottom 

(4)  top 

Type:  Integer 

Use:  These  arguments  specify  the  limits  of  the  rectangle 
to  be  drawn. 

(5)  colour 

Type:  Integer 

Use:  This  argument  specifies  the  colour  in  which  the  rec¬ 
tangle  is  to  be  drawn,  and  should  be  between  0  and  25S 
Inclusive.  If  colour  is  omitted,  the  current  colour 
is  used;  if  specified,  it  replaces  the  current 
colour.  If  colour  is  out  of  range,  the  least  sig¬ 
nificant  eight  bits  are  used. 

4.6. 3.3  Errors 

This  routine  calls  SEND-DATA  and  hence  a  fatal  error  will  result  if 
there  has  been  no  previous  call  to  GRAPHI(L-INIT. 

4.6.4  Subroutine  DlA«_MAP_BOXES (test-colour) 

4.6.4. 1  Purpose 

This  routine  allows  a  user  to  view  the  colour  sap  of  the  current  display 
quadrant  of  the  current  controller.  It  fills  the  screen  with  256  rec¬ 
tangles  -  one  in  each  colour  of  the  map,  and  then  writes  the  colour  number 


of  each  (In  hexadecimal  radix)  onto  the  rectangle.  The  user  specifies  the 
colour  of  this  text . 

4. 6. 4. 2  Arguments 

DRAW-K4P-B0XES  has  one  argument: 

(1)  test-colour 
Type:  integer 

Use:  This  argument  specifies  the  colour  of  the  text  which 
is  written  into  each  rectangle,  identifying  its 
colour  number,  and  should  be  between  0  and  255 
Inclusive. 

4.6. 4.3  Errors 

This  routine  calls  SEND— DATA  and  hence  a  fatal  error  will  result  if 
there  has  been  no  previous  call  to  GRAPHIC— IN1T. 

4.7  Utility  Routines 

4.7.1  General 

These  routines  provide  some  capabilltes  for  the  translation  of  pictures 
from  pixel  colour  data  to  graphic  controller  instructions  and  vice  versa. 
These  routines  do  not  interact  with  the  raster  graphic  controller  and  hence 
it  is  not  necessary  to  call  GRAPHIC— INIT  prior  to  their  use. 

4.7.2  Subroutine  DECIPHER (Inst ructions ,nun— last .log-unit .seq-nun) 

4. 7. 2.1  Purpose 

This  routine  decodes  16-bit  graphic  controller  instruction  words.  The 
output  can  be  directed  to  the  user’s  terminal  or  to  a  file  for  printing. 

4. 7. 2. 2  Arguments 

DECIPHER  has  four  arguments: 

(1)  instructions 

Type:  integer*2  array  or  logical *2  array 

Use:  This  argument  specifies  the  array  containing  the 
sequence  of  Instructions  to  be  decoded. 

(2)  nua_ins t 
Type:  Integer 

Use:  This  argument  specifies  the  length  of  the  array  in¬ 
structions,  i.e.  the  number  of  instructions  to  be 
decoded. 

(3)  log— unit 
Type:  integer 

Use:  This  argument  specifies  a  FORTRAN  logical  unit  number 
on  which  the  output  file  has  been  opened.  If 

log— unit  is  specified  as  zero  or  negative,  outnut  is 
directed  to  the  user’s  terminal. 

(4)  seq— nun 

Type:  integer 

Use:  This  argument  specifies  the  sequence  number  that  will 
prefix  the  first  line  of  output  from  this  routine. 
Each  instruction  word  is  deciphered  into  one  line  of 
output,  comprising  the  sequence  number,  the  instruc¬ 
tion  and  its  translation,  seq— num  is  incremented 
after  each  instruction  is  decoded,  so  that  several 
calls  to  DECIPHER  (without  the  user  altering 
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seq_ now)  will  result  in  the  sequence  numbers  being 
continuous. 

4. 7. 2. 3  Errors 

DECIPHER  detects  no  errors.  However,  a  warning  is  issued  if  an  instruct 
tlon  is  not  recognised  as  valid. 

4.7.3  Subroutine  UPDATE— PICTURE (old pie, newpic, 

left (right , bottom, top, instructions, num-lmst) 

4.7.3. 1  Purpose 

This  routine  produces  the  graphic  controller  instructions  necessary  to 
convert  one  picture  into  another.  It  achieves  this  by  coaparing  the  new 
picture  with  the  old  picture,  row  by  row,  and  converting  the  differences 
into  a  sequence  of  set  and/or  incremental  move  instructions.  For  example, 
if  a  user  wishes  to  set  up  a  sequence  depicting  a  moving  (singly-coloured) 
object,  this  routine  would  produce  those  instructions  which  would  replace 
the  trailing  edge  with  the  background,  and  replace  the  background  with  the 
leading  edge.  If  it  is  known  in  advance  that  the  differences  in  the  two 
pictures  are  restricted  to  a  particular  (rectangular)  region,  the  ex¬ 
ecution  speed  of  this  routine  can  be  Increased  by  restricting  the  operation 
of  UPDATE_PICTURE  to  that  region. 

This  routine  can  be  used  to  generate  a  sequence  of  frames  for  display  as 
a  moving  sequence  with  the  MANPIX  command  MOVIE  (see  section  5.3.2). 

4.7.3. 2  Arguments 

UPDATE-PICTURE  has  eight  arguments: 

(1)  oldplc 

Type:  logical*!  array  (0:511,0:511) 

Use:  This  argument  specifies  the  array  containing  the 
original  picture  which  is  to  be  undated,  with  each 
element  specifying  the  colour  of  the  corresponding 
pixel  of  the  picture.  Note  that  the  dimensions  of  the 
array  must  be  as  specified,  i.e.,  the  whole  screen 
must  be  Included. 

(2)  newpic 

Type:  loglcal*l  array  (0:511,0:511) 

Use:  This  argument  specifies  the  array  containing  the  new 
picture  which  will  result  when  the  old  picture  is  up¬ 
dated.  This  must  also  be  dimensioned  as  specified. 

(3)  left 

(4)  right 

(5)  bottom 

(6)  top 

Type :  integer 

Use:  If  it1' is  known  in  advance  that  the  differences  in  ol- 
dpic  and  newpic  are  restricted  to  a  particular  rec¬ 
tangle  of  the  screen,  the  speed  of  this  routine  can  be 
Increased  by  specifying  the  limits  of  this  rectangle 
with  these  arguments.  If  such  limits  are  unknown,  or 
the  differences  are  not  restricted,  specify  left, 
right,  bottom  and  top  as  0,  511,  0  and  511 

respectively. 
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(7)  instruct loos 

Type:  integer*2  array  or  logical *2  array 
Use:  This  argument  specifies  the  array  into  which  the 
sequence  of  Instructions  will  be  written.  These  in¬ 
structions  ,  when  sent  to  the  controller  displaying 
oldpic,  will  transform  the  picture  into  nevpic. 

(8)  nun— Inst 
Type :  Integer 

Use:  This  argument  specifies  the  nunber  of  instructions 
written  into  the  array  instructions.  It  is 
therefore  necessary  that  the  instructions  array  be 
dimensioned  sufficiently  large  in  the  calling 
program. 

4.7. 3.3  Errors 

UPDATE-PICTURE  detects  no  errors.  However,  no  Instructions  will  be 
generated  if  left  is  greater  than  right,  or  if  bottom  is  greater  than  top. 

4.7.4  Subroutine  UPDATE— ROM 

( row, oldrow.newrow, instruct ions , nun— lost ) 

4. 7. 4.1  Purpose 

This  routine  produces  the  graphic  controller  instructions  necessary  to 
convert  one  row  of  pixels  into  another  row  of  pixels.  It  works  in  exactly 
the  sane  way  as  UPDATE_P1CTURE ,  and  is  used  when  it  is  undesirable  or  im¬ 
practicable  to  work  on  the  whole  picture  at  once. 

4. 7. 4. 2  Arguments 

UPDATE— ROW  has  five  arguments: 


row 

Type: 
Use : 


integer 

This  argument  specifies  the  row  under  consideration. 
It  is  required  so  that  any  set  Instructions  produced 
will  affect  the  correct  row  of  the  picture. 


oldrow 

Type:  logicalM  array  (0:511) 

Use:  This  argument  specifies  the  array  containing  the 
original  row  to  be  updated,  with  each  element 
specifying  the  colour  of  each  pixel  of  the  row.  Note 
that  the  dimensions  of  the  array  must  be  as 
specified  > 


Type:  logicalM  array  (0:511) 

Use:  This  argument  specifies  the  arrav  containing  the  new 
row  which  will  result  when  the  old  row  is  updated. 
This  must  also  be  dimensioned  as  specified. 

(4)  Instructions 

Type:  integer*2  array  or  logical *2  array 
Use:  This  argument  specifies  the  array  into  which  the 
sequence  of  instructions  will  be  written.  Note  that 
this  array  must  be  dimensioned  large  enough  in  the 
calling  program  to  hold  the  Instructions  generated. 

(5)  num-lnst 
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Use:  This  argument  specifies  the  number  of  Instructions 
written  into  the  srray  Instructions. 


4. 7.5  Subroutine  SEPARATE— UPDATE— ROW(row,oldrow,newrow, 
object— in— new, 

back— Inst r, back— ptr .object— Inst r, object— ptr) 

4.7.5. 1  Purpose 

This  routine  produces  the  graphic  controller  Instructions  necessary  to 
convert  one  row  of  pixels  into  another  row  of  pixels.  It  works  in  a  slailar 
way  to  UPDATEL.ROW  except  that  the  graphics  instructions  are  placed  into  two 
output  arrays  -  one  for  the  background  and  one  for  an  object.  Thus,  by 
sending  the  background  sequence  of  instructions  to  the  controller  before 
the  object  instructions,  the  trailing  edge  of  a  "aoving"  object  can  be 
restored  as  background  before  the  leading  edge  is  drawn.  This  approach 
can,  in  some  circumstances,  overcome  the  problem  of  double  Images  which  may 
arise  if  background  and  object  are  drawn  on  a  row  by  row  basis  (as  would  oc¬ 
cur  with  the  single  instruction  array  generated  by  UPDATE— PICTURE  or  UP¬ 
DATE— ROW).  The  separation  of  background  and  object  is  achieved  with  a 
user-supplied  array  which  flags  the  object  pixels  in  the  new  row. 

4. 7. 5. 2  Arguments 

SEPARATE-JUPDATE— ROW  has  eight  arguments: 

( 1 )  row 

Type :  Integer 

Use:  This  argument  specifies  the  row  under  consideration. 
It  is  required  so  that  any  set  Instructions  produced 
will  affect  the  correct  row  of  the  picture. 

(2)  oldrow 

Type:  logical*l  array  (0:511) 

Use:  This  argument  specifies  the  array  containing  the 
original  row  to  be  updated,  with  each  element 
specifying  the  colour  of  each  pixel  of  the  row.  Note 
that  the  dimensions  of  the  array  must  be  as 
specified . 

(3)  newrow 

Type:  logical*l  array  (0:511) 

Use:  This  argument  specifies  the  array  containing  the  new 
row  which  will  result  when  the  old  row  is  updated. 
This  must  also  be  dimensioned  as  specified. 

(4)  object— in— new 

Type:  logical*l  array  (0:511) 

Use:  This  argument  is  a  flag  array  which  specifies  those 
pixels  in  the  new  row  which  contain  the  object  of  in¬ 
terest.  These  pixels  are  indicated  by  a  value  of  1, 
and  instructions  for  these  will  go  into  the  object 
output  array.  Background  pixels  are  indicated  by  a 
value  of  0,  and  their  instructions  will  be  placed 
Into  the  background  array.  This  must  also  be  dimen¬ 
sioned  as  specified. 

(5)  back— lnstr 

Type:  integer*2  array  or  logical*2  array 
Use:  This  argument  specifies  the  array  into  which  the 
sequence  of  instructions  for  updating  the  background 
part  of  the  picture  will  be  written.  Note  that  this 


array  must  be  disansioned  large  enough  in  the  calling 
program  to  hold  the  instructions  generated* 

(6)  back— ptr 
Type:  Integer 

Use:  This  arguaent  specifies  the  nuaber  of  instructions 
written  into  the  array  back_lastr.  It  is  a  pointer 
to  the  last -used  eleaent  of  the  array,  and  should  be 
lnitisllsed  by  the  user  before  this  routine  is 
called. 

(7)  object— lastr 

Type:  lnteger*2  array  or  loglcal*2  array 

Use:  This  arguaent  specifies  the  array  into  which  the 
sequence  of  instructions  for  updating  the  object  part 
of  the  picture  will  be  written.  Note  that  this  array 
aust  be  dimensioned  large  enough  in  the  calling  prog¬ 
ram  to  hold  the  instructions  generated. 

(8)  object— ptr 
Type :  Integer 

Use:  This  arguaent  specifies  the  number  of  instructions 
written  into  the  array  object— laatr.  It  is  a  poin¬ 
ter  to  the  last-used  eleaent  of  the  array,  and  should 
be  initialised  by  the  user  before  this  routine  is 
called. 


4.7.6  Subrout  lac  PIC-TOu»STK(plc, 

lef t , right , hot toa , top , iaat  ruct ioaa , nua-ias t ) 

4. 7.6. 1  Purpose 

This  routine  produces  the  graphic  controller  instructions  necessarv  to 
display  a  picture.  The  picture  is  processed  on  a  row  by  row  basis,  and  each 
row  is  stored  as  either  a  dump-mode  restore  instruction  or  as  a  group  of  set 
and  increaental  move  Instructions,  according  to  whichever  occupies  the 
lesser  aaount  of  space.  This  routine  thus  produces  the  aost  efficient 
aeans  of  storing  a  picture. 

4. 7. 6. 2  Arguaent s 

PIC—TO—INSTR  has  seven  arguments: 

(1)  pic 

Type:  loglcal*l  array  (left :rlght ,bottoa:top) 

Use:  This  argument  specifies  the  array  containing  the 
original  picture  which  is  to  be  converted  to  graphic 
instructions,  with  each  element  specifying  the 
colour  of  the  corresponding  pixel  of  the  picture. 
Note  that  the  dimensions  of  the  array  must  be  as 
specified  by  the  next  four  arguments  of  this  routine. 

(2)  left 

(3)  right 

(4)  bottoa 

(3)  top 

Type:  Integer 

Use:  These  arguments  specify  the  dimensions  of  the  picture 
to  be  converted  to  graphics  instructions.  Note  that 
these  are  also  the  dimensions  of  the  pic  array. 


(6)  Instructions 

Type:  integer*2  array  or  logical*2  array 
Oae:  This  argument  specifies  the  array  into  which  the 
sequence  of  instructions  will  be  written.  These  in¬ 
structions,  when  sent  to  a  controller,  will  result  in 
the  original  picture  being  displayed. 

(7)  nun-last 
Type:  integer 

Use:  This  argument  specifies  the  number  of  instructions 
written  into  the  array  instructions.  It  is 
therefore  necessary  that  the  instructions  array  be 
dimensioned  sufficiently  large  in  the  calling 
program. 

4. 7. 6. 3  Errors 

PIC—70— INSTR  detects  no  errors.  However,  no  Instructions  will  be 
generated  if  left  is  greater  than  right,  or  if  bottom  is  greater  than  top. 


4.7.7  Subroutine  IHST1— TO— PIC(instruetions, nun— Inst , 
picture! , clear [, error) ) ) 

4. 7. 7.1  Purpose 

This  routine  "colours"  the  elements  of  a  picture  array  according  to  a 
given  sequence  of  graphic  instructions,  i.e.,  it  operates  on  the  picture 
array  in  the  same  way  that  the  graphic  controller  operates  on  its  memory, 
with  the  exception  that  instructions  involving  colour  map  quadrants  are 
Ignored,  as  are  mask,  synchronisation,  scrolling  and  dump-node  saving  in¬ 
structions.  INSTR_TO_PIC  is  the  reverse  of  PIC_TO_INSTR.  Note  that  this 
routine  initialises  colour  and  x  and  y  coordinates  to  zero. 

4. 7. 7. 2  Arguments 

1NSTR— TO— PIC  has  five  arguments,  the  last  two  being  optional: 

(1)  instructions 

Type:  lnteger*2  array  or  loglcal*2  array 
Use:  This  argument  specifies  the  array  containing  the 
sequence  of  Instructions  that  are  to  be  written  into 
the  picture  array  (described  below). 

(2)  nun-lost 

Type :  integer 

Use:  This  argument  specifies  the  length  of  the  instruc¬ 
tions  array. 

(3)  picture 

Type:  logical*!  array  (0:511,0:511) 

Use:  This  argument  specifies  the  array  which  contains  one 
element  for  each  pixel  on  the  screen.  This  array  will 
be  altered  according  to  the  instructions  in  the  in¬ 
structions  array.  Note  that  this  array  must  be 
dimensioned  as  specified. 

(4)  clear 

Type:  logical 

Use:  This  argument  specifies  whether  or  not  the  picture 
array  is  to  be  zeroed  before  applying  the  instruc¬ 
tions  array.  If  clear  is  omitted,  it  is  assumed  to 
be  false,  i.e.,  the  picture  array  is  not  cleared 
first . 


(5)  error 

Type:  logical 

Use:  This  argument  la  written  by  INSTR-TO-PIC,  and  la  set 
to  true  if  an  instruction  to  write  outside  the  screen 
area  was  detected*  If  this  argument  is  omitted*  no 
such  indication  of  error  is  given. 

4.7. 7.3  Errors 

INSTR-XO— PIC  will  return  lomediately  to  the  calling  program  if  an  in¬ 
struction  to  write  outside  the  screen  area  was  interpreted.  If  the  error 
argument  was  specified,  it  trill  be  set  to  true  before  INSTR—TQ-PIC  returns. 

4.7.8  Subroutine  FILL_ARRAY(array,num— elements, value) 

4.7.8. 1  Purpose 

This  routine  employs  the  LIBSM0VC5  routine  in  the  VAX  run-time  library 
to  fill  a  byte  array  with  a  particular  value.  One  use  of  this  routine  would 
be  to  clear  out  picture  arrays,  since  it  is  far  more  efficient  than  a  pair 

of  “do"  loops.  FILL-ARRAY  partitions  the  array  into  blocks  of  slse  65535  or 
less,  (the  maximum  size  for  LIB$M0VC5)  and  then  calls  LIBSM0VC5  to  fill  the 
array. 

4. 7. 8. 2  Arguments 

FILL-ARRAY  has  three  arguments: 

(1)  array 

Type:  logical *1  array 

Use:  This  argument  specifies  the  array  whose  elements  are 
to  be  filled.  Note  that  it  is  a  byte  array. 

(2)  sum-elements 
Type :  integer 

Use:  This  argument  specifies  the  number  of  elements  in  ar¬ 
ray  that  are  to  be  filled,  num-alenemta  should  be 
not  greater  than  the  dimension  of  array  in  the  cal¬ 
ling  program. 

(3)  value 

Type:  integer 

Use:  This  argument  specifies  the  value  to  be  placed  into 
each  element  of  array.  Note  that  only  the  least  sig¬ 
nificant  eight  bits  of  value  are  used. 

5.  MANPIX  USER*  S  GUIDE 

MANPIX  is  a  program  which  may  be  used  for  displaying  and  manipulating 
pictures  on  the  graphic  controller  screens.  It  also  allows  a  user  to  alter 
colour  maps,  read  back  parts  of  the  picture,  and  to  send  individual  in¬ 
structions  to  the  controllers. 

MANPIX  maintains  the  concept  of  "active  screens"  which  the  user  defines 
with  a  UNIT  command  (section  5.1.2)  and  subsequent  commands  generally  af¬ 
fect  those  screens  which  are  currently  active.  MANPIX  commands  fall  into 
three  categories  -  those  which  are  independent  of  the  active  screen  en¬ 
vironment,  those  which  operate  on  all  active  screens  with  common  parameters 
(or  no  parameters),  and  those  where  a  separate  parameter  must  be  provided 
for  each  active  screen.  The  common  parameter  commands  result  in  repeated 
transmissions  of  the  same  group  of  graphic  controller  instructions  -  one 
for  each  screen,  whereas  the  separate  parameter  commands  generally  tran¬ 
smit  different  groups  of  instructions. 


iaik  atefis 


To  run  MANPIX  typo: 


HANP1X 


to  tho  "$".  Tho  program  will  respond  with  the  proapt  "Command:",  to  which  e 
coaaend  string  aust  be  typed*  Alternatively*  the  first  eoaaend  to  MANPIX 
can  be  entered  with  the  progrea  naae  by  typing 

MANPIX  <coaaand-line> 

to  the  la  that  case*  MANPIX  will  execute  the  requested  coaaand  before 

issuing  the  proapt.  Note  that  MANPIX  converts  all  letters  on  input  to  upper 
case*  so  that  coaasnds  can  be  entered  in  either  case.  For  clarity*  coaaands 
discussed  below  will  be  expressed  in  upper  ease. 

5.1  Coaaaads  Independent  of  the  Active  Screen  Bavlronaeat 

5.1.1  HELP  Coaaand 

A  listing  of  the  available  commands  can  be  obtained  at  the  user's  ter¬ 
minal  by  entering  the  coaaand  HELP  (either  by  typing  MANPIX  HELP  to  the  "$" 
or  by  typing  HELP  to  the  "Coaaand:**  proapt).  MANPIX  will  respond  as 
follows: 


The  following  coaaands  are  available: 


AFRAME 

BOX 

CLEAR 

COLUMN 

DISPLAY 

DOTMOVE 

ECOLUMN 

EROW 

EXCHANGE 

FILLMAP 

FRAME 

HELP 

INSTRUCTION 

MAP 

MFRAME 

MOVIE 

MSHOU 

ROW 

SCROLL 

SET 

SHOW 

TRANSFER 

UNIT 

VIEWMAP 

ZOOM 


show  picture  frame  with  "adaptive"  map  in  file 
draw  a  box  in  a  nominated  colour 
clear  the  screen 

draw  one  or  more  columns  in  a  nominated  colour 

display  a  number  in  decimal*  octal  and  hexadecimal 

show  a  dot  moving  in  a  rectangular  path 

read  back  part  or  all  of  a  column  from  controller  memory 

read  back  part  or  all  of  a  row  from  controller  memory 

exchange  the  pictures  on  two  screens 

fill  up  the  colour  map  with  a  single  value 

show  a  picture  frame  stored  as  graphic  instructions 

this  message  or  more  details  on  each  command 

execute  single  graphic  instructions 

load  a  colour  map 

show  multiple  picture  frame  graphic  instruction  files 
show  a  sequence  of  frames  as  a  "movie" 
show  multiple  pictures  stored  in  files  as  pixel  data 
draw  one  or  more  rows  in  a  nominated  colour 
scroll  the  picture 

set  all  pixels  to  a  nominated  colour 

show  a  picture  stored  in  a  file  as  pixel  information 

transfer  a  picture  from  one  screen  to  another 

select  which  screen  units  are  to  be  active 

view  the  colours  in  the  colour  map 

room  in  on  the  picture  currently  being  displayed 


These  commands  can  be  abbreviated  provided  that  enough  is  specified  to 
distinguish  between  them.  However,  since  more  commands  may  be  added  at  a 
future  stage,  it  is  recommended  that  a  minumum  of  three  characters  is  used. 

Groups  of  commands  can  be  assembled  into  a  file  (one  command  per  line) 
and  executed  together  by  issuing  the  command  "^filename",  where  filename  is 
the  name  of  the  file  containing  the  commands.  Note  that  such  a  command  file 
cannot  contain  another  "@"  command.  It  is  recommended  that  the  file  type 
".MPX"  be  used  for  MANPIX  command  files. 


Parameter*  to  commands  must  be  separated  by  one  or  sore  apace*.  Note 
that  soae  coaaandi  have  optional  parameter*  -  these  will  be  shown  In  brac¬ 
kets  (()),  with  nesting  of  the  brackets  where  appropriate. 

Where  integers  are  to  be  specified ,  octal  constants  can  be  entered  by 
prefacing  thea  with  a  letter  "o",  hex  constants  by  prefacing  with  a  letter 


Command  format:  HELP  (command] 

Parameters:  command  -  the  command  about  which  information  is  sought 

If  command  is  omitted,  the  above  description  of  all  commands  is  given. 

5.1.2  UNIT  Command 

This  command  is  used  to  select  which  of  the  three  controller  screens  are 
to  be  active.  Note  that  when  MANPIX  is  first  entered,  screen  1  (the  centre 
screen)  is  the  only  active  screen. 

Command  format:  UNIT  screen-1  (  screen-2  [  screen-3)) 

Parameters:  screen-n  -  one  of  0,  1  or  2  to  indicate  a  screen  which  is 

to  become  active. 

One,  two  or  all  three  screens  can  be  currently  active.  The  order  in 
which  they  are  specified  in  the  UNIT  command  dictates  the  order  in  which 
changes  will  be  made  on  each  active  screen.  Note  that  the  screens  selected 
by  this  command  remain  active  until  another  UNIT  command  is  entered. 

5.1.3  TRANSPEK  Command 

This  command  transfers  the  picture  from  one  screen  to  another,  without 
affecting  the  picture  on  the  first  screen,  resulting  in  two  screens  having 
the  same  picture  in  controller  memory.  It  functions  by  reading  the  picture 
back  from  the  first  controller’s  memory,  then  transmitting  the  data  to  the 
second  controller. 

Command  format :  TRANSFER  screen-1  screen-2 

Parameters:  screen-1  -  the  screen  containing  the  picture  to  be 

transferred 


screen-2  -  the  destination  screen 

Note  that  this  command  does  not  alter  the  current  list  of  active  screens. 

5.1.4  EXCHANGE  Command 

This  command  exchanges  the  pictures  on  two  of  the  screens.  It  functions 
by  reading  the  pictures  back  from  each  of  the  selected  controllers,  and 
then  transmitting  the  data  to  the  opposite  screens. 

Command  format:  EXCHAN (3!  screen-1  screen-2 

Parameters:  screen-n  -  the  screens  involved  in  the  exchange 


Note  that  this  command  does  not  alter  the  current  list  of  active  screens. 

5.1.5  DISPLAY  Command 

This  is  a  utility  command  to  display  one  or  more  integers  In  decimal, 
octal  and  hexadecimal  representation.  The  values  are  displayed  on  the 
user’s  terminal,  not  on  the  graphic  screen. 


Command  format:  DISPLAY  nl  (n2  {n3  [n4  (n5  (n6  (n7  fn8  (n9  (nlO]) )])]]]! 
Parameters:  the  numbers  to  be  displayed  (up  to  10  can  be  entered  at  a 

time) 

To  enter  a  number  In  octal,  prefix  it  with  a  letter  "o". 

To  enter  a  number  in  hexadecimal,  prefix  it  with  a  letter  "x". 

5.1.6  QUIT  Command 

This  command  causes  MANPIX  to  exit  to  the  VMS  operating  system. 

Command  format:  QUIT 
No  parameters. 

5.2  ComaKMi  Parameter  Commands 

5.2.1  General 

The  commands  in  this  category  act  sequentially  upon  the  active  control* 
lers,  in  turn,  and  in  the  order  that  they  were  selected  by  the  most  recent 
UNIT  command  (section  5.1.2).  Three  of  these  commands,  namely  ECOLUMN 
(section  5.2.7),  EROW  (section  5.2.8)  and  ZOOM  (section  5.2.18)  require 
that  only  one  screen  be  currently  active;  the  others  are  valid  for  one,  two 
or  three  active  screen  cases. 

5.2.2  AFRAME  Command 

This  command  operates  on  a  file  which  contains  both  graphic  controller 
colour  map  information  and  picture  information.  It  sets  up  the  colour  mao 
of  each  of  the  active  controllers,  then  displays  the  stored  picture  on 
each.  The  file  must  contain  the  picture  information  as  a  series  of  graphic 
instructions  (rather  than  containing  the  colour  of  each  pixel  explicitly). 
This  is  generally  the  most  efficient  method  of  storing  a  picture,  and 
results  in  the  fastest  subsequent  display.  The  file  must  be  set  up  as  a 
FORTRAN  binary  file,  with  each  frame  being  stored  as  one  record  in  the  fol¬ 
lowing  format  (note  the  different  length  Integers): 


red(0:255)  logicalM  array 

green(0:255)  loglcalM  array 

blue(0:255)  logicalM  array 

n  ■  number  of  instructions  stored  integer** 

lnstructlons( 1 :n)  integer*2  or  logical*2  array 

The  three  logical *1  arrays  contain  the  red,  green  and  blue  components  of 
the  colour  map,  and  should  be  written  as  a  separate  FORTRAN  record  from 
that  containing  the  picture  instructions.  A  typical  FORTRAN  sequence  to 
produce  the  correct  format  would  be  as  follows: 

logical *1  red(0: 2 55), green (0: 255), blue (0: 255) 

integer*4  n 

logical*2  instr(lOOOO) 

(code  to  generate  map  and  instructions) 


write(l)  red , green , blue 
write(l)  n,(instr(i),i*l,n) 


Command  format:  AFRAME  filename  [frame-number) 

Parameters:  filename  -  the  name  of  the  binary  file  containing  the 

frame(a)  of  colour  maps  and  graphic 
instructions 

frame-number  -  the  frame  number  in  the  file  to  be  shown 
(first  frame  is  number  1) 

If  frame-number  is  omitted,  it  is  assumed  to  be  1. 

5.2.3  BOX  Comaamd 

This  command  will  draw  a  rectangle  on  each  of  the  active  screens  in  a 
nominated  colour . 

Command  format:  BOX  colour  left  right  bottom  top 
Parameters:  colour  -  number  in  colour  map  for  the  hox’s  colour 

left  -  pixel  number  of  left-hand  edge 
right  -  pixel  number  of  right-hand  edge 
bottom  -  row  number  of  bottom  edge 
top  -  row  number  of  top  edge 

5.2.4  CLKA1  command 

This  command  clears  each  of  the  active  screens  by  setting  all  pixels  of 
each  controller  to  colour  zero.  It  is  assumed  that  colour  zero  is  set  up  as 
black  in  the  colour  map.  Note  that  CLEAR  is  equivalent  to  SET  0  (the  SET 
command  is  described  below  in  section  5.2.15). 

Cosssand  format:  CLEAR 
No  parameters. 

5.2.5  COLUMN  command 

This  command  fills  one  or  more  columns  of  each  of  the  active  screens  In  a 
nominated  colour.  All  512  pixels  of  each  column  are  coloured. 

Command  format:  COLUMN  colour  start-pixel  [finish-pixel] 

Parameters:  colour  -  number  in  colour  map  for  column  colour 

start-pixel  -  pixel  number  of  the  left-most  column 
finish-pixel  -  pixel  number  of  the  right-most  column 

If  finish-pixel  is  omitted,  one  column  is  coloured  at  the  start-pixel 
location. 

5.2.6  DOTMOVE  Command 

This  command  causes  a  dot  to  move  in  a  rectangular  path  on  each  of  the 
active  screens. 

Command  format:  DOTMOVE  colour  left  right  bottom  top 
Parameters:  colour  -  number  in  colour  map  for  the  dot's  colour 

left  -  pixel  number  of  left-hand  edge  of  path 

right  -  pixel  number  of  right-hand  edge  of  path 

bottom  -  pixel  number  of  bottom  edge  of  path 

top  -  pixel  number  of  top  edge  of  path 

Note:  the  dot  keeps  moving  until  a  carriage  return  is  typed. 

5.2.7  ECOLOMN  Command 

This  command  enables  a  user  to  examine  part  or  all  of  a  column  of  pixels 
by  reading  back  from  the  graphic  controller’s  memory.  Note  that  only  one 
screen  can  be  active  for  this  command  to  execute  successfully  -  if  there  is 
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■ore  Chan  one  screen  currently  active  an  error  message  vlll  be  given  and 
MANPIX  will  request  another  command* 

Command  format:  ECOUJMN  column-number  start-row  [finish-row] 

Parameters:  column-number  -  pixel  number  of  column  to  be  examined 

start-row  -  first  row  of  the  column  to  be  read  back 
finish-row  -  last  row  of  the  column  to  be  read  back 

All  pixels  in  the  column  between  start-row  and  finish-row  (inclusive) 
are  read  back  from  the  controller's  memory  and  displayed  at  the  user's  ter¬ 
minal.  If  the  user  requires  the  data  on  a  file  rather  than  at  the  terminal, 
then  the  logical  name  FOR$TYPE  should  be  directed  to  a  file  before  running 
MANPIX  (e.g.  by  Issuing  the  command  DEFINE/USER  FOR$TYPE  filename. typ). 
Note  that  colour  values  are  given  in  hexadecimal  to  reduce  space 
requirements.  However,  conversion  of  values  to  octal  or  decimal  can  be 
achieved  with  the  DISPLAY  command  (see  section  S.l.S). 

If  finish-row  is  omitted,  one  pixel  only  is  read  back  -  that  pixel  whose 
screen  coordinates  are  (column -number , start-row). 

5.2.8  EKOW  Command 

This  command  enables  a  user  to  examine  part  or  all  of  a  row  of  pixels  by 
reading  back  from  the  graphic  controller's  memory.  It  is  the  same  as  the 
ECOLUMN  command  (section  5.2.7)  except  that  it  reads  horizontally  rather 
than  vertically.  Note  that  only  one  screen  can  be  active  for  this  command 
to  execute  successfully  -  if  there  is  more  than  one  screen  currently  active 
an  error  message  will  be  given  and  MANPIX  will  request  another  command. 

Command  format:  EROW  row-number  start-pixel  [finish-pixel] 

Parameters:  row-number  -  row  (y-coordinate)  to  be  examined 

start -pixel  -  first  pixel  of  the  row  to  be  read  back 
finish-pixel  -  last  pixel  of  the  row  to  be  read  back 

All  pixels  in  the  row  between  start-pixel  and  finish-pixel  (inclusive) 
are  read  back  from  the  controller's  memory  and  displayed  at  the  user’s  ter¬ 
minal.  If  the  user  requires  the  data  on  a  file  rather  than  at  the  terminal, 
then  the  logical  name  FOR$TYPE  should  be  re-directed  as  mentioned  above  in 
the  ECOLUMN  command  (section  5.2.7).  As  in  the  case  of  the  ECOLUMN  command, 
values  are  given  in  hexadecimal. 

If  finish-pixel  is  omitted,  one  pixel  only  is  read  back  -  that  pixel 
whose  screen  coordinates  are  ( start -pixel , row-number ). 

5.2.9  PILLMAP  Command 

This  command  is  used  to  fill  all  256  colours  in  the  map  of  each  active 
controller  with  a  single  value.  Note  that  the  current  colour  map  quadrant 
is  used.  If  a  different  quadrant  is  required,  it  can  be  selected  using  the 
INSTRUCTION  command  (section  5.2.11)  or  the  VIEWMAP  command  (section 
5.2.17). 

Command  format:  FILLMAP  red  green  blue 

Parameters:  red  -  value  of  red  component  to  go  in  the  mao 

green  -  value  of  green  component  to  go  in  the  map 
blue  -  value  of  blue  component  to  go  in  the  map 

5.2.10  FRAME  Command 

This  command  displays  on  each  active  screen  a  picture  stored  in  a  file 
as  a  series  of  graphic  instructions  (rather  than  storing  explicitly  the 
colour  of  each  pixel).  It  is  the  same  as  the  AFRAME  command  (section  5.2.2) 
except  that  the  file  contains  no  information  about  the  colour  map.  The  file 
must  be  set  up  as  a  FORTRAN  binary  file,  with  each  frame  being  stored  as  one 
record  in  the  following  format: 


n  »  number  of  instructions  stored 
lnstructlons( 1 :n) 


integer** 

integer*2  or  logical *2  array 


Command  format:  FRAME  filename  (frame-number) 

Parameters:  filename  -  the  name  of  the  binary  file  containing  the 

frame(s)  of  graphic  instructions 

frame-number  -  the  frame  number  in  the  file  to  be  shown 
(first  frame  is  number  1) 

If  frame-number  is  omitted,  it  is  assumed  to  be  1. 

5.2.11  INSTRUCTION  Command 

This  command  enables  a  user  to  send  individual  instructions  to  all 
graphic  controllers  that  are  currently  active.  All  instructions  except  the 
dump-mode  save  and  restore  instructions  can  be  transmitted. 

Command  format :  INSTRUCTION  code  parameter-list 

Parameters:  code  -  a  1  or  2  letter  code  representing  the  in¬ 

struction  to  be  sent  (see  below) 

parameter-list  -  required  parameters  for  the  instruction 
The  following  instructions  can  be  sent: 


code 

parameter-list 

1 

(incremental  move) 

x-move  y-move  repeat -count 

1 

(load  colour  map  word) 

address  red  green  blue 

X 

(set  x  coordinate) 

x-value 

y 

(set  y  coordinate) 

y-value 

xw 

(set  x  &  write  pixel) 

x-val ue 

yw 

(set  y  &  write  pixel) 

y-value 

c 

(set  colour) 

colour 

cw 

(set  colour  &  write  all  pixels) 

colour 

m 

(set  mask) 

mask -value 

qw 

(select  write  quadrant) 

quadrant -number 

qd 

(select  display  quadrant) 

quad  rant -number 

s 

(scroll ) 

x-move  y-move 

sr 

(scroll  reset) 

<none> 

d  i 

(disable  picture  display) 

<none> 

5.2.12  MAP  Command 

This  command  is  used  to  load,  into  each  controller  that  is  currently  ac¬ 
tive,  a  colour  map  which  has  been  set  up  previously  in  a  FORTRAN  binary 
file.  Note  that  the  current  colour  map  quadrant  is  used.  If  a  different 
quadrant  is  required,  it  can  be  selected  using  the  INSTRUCTION  command 
(section  5.2.11)  or  the  VIEWMAP  command  (section  5.2.17).  The  MAP  command 
requires  that  the  FORTRAN  binary  file  be  set  un  as  one  record  in  the  format 

used  by  subroutine  LOAD— MAP— FILE  of  the  FLISGRAPH  package  (see  section 
4.3.8). 


Command  format:  MAP  filename 
or  MAP  ? 

Parameters:  filename  -  the  name  of  the  colour  map  file 

If  filename  is  specified,  the  MAP:  directory  is  searched  for  the  file. 
If  that  search  falls,  the  user’s  directory  is  searched,  and  if  that  fails  an 
error  results.  If  the  file  is  found,  the  colour  map  is  loaded. 


i^ji,<  -a  jjt.  ..........a  * 


If  ?  Is  specified,  Che  user  is  given  Che  names  of  Che  colour  map  files  in 
Che  MAP:  direcCory  (one  by  one),  and  asked  if  ChaC  file’s  map  is  Co  be 
loaded.  Once  Che  user  chooses  a  file,  char  map  is  loaded.  If  no  choice  is 
made,  no  acClon  is  Caken. 

5.2.13  ROW  command 

This  command  fills  one  or  more  rows  of  each  acClve  screen  in  a  nomlnaCed 
colour.  All  512  pixels  of  each  row  are  coloured.  This  is  similar  Co  Che 
COLUMN  command  (secdon  5.2.5),  excepC  ChaC  ic  works  horizontally  raCher 
Chan  vercically. 

Command  formac :  ROW  colour  scarc-row  (finish-row] 

ParameCers:  colour  -  number  in  colour  map  for  Che  column  colour 

scarc-row  -  number  of  Che  lowesC  row  Co  be  coloured 
finish-row  -  number  of  Che  highest  row  Co  be  coloured 

If  finish-row  is  omlcced,  one  row  is  coloured  aC  Che  scarC-row  locacion. 

5.2.14  SCROLL  command 

The  SCROLL  command  causes  Che  plcCure  on  each  acClve  screen  Co  be  shif- 
Ced  horizoncally,  vercically,  or  boch*  Wrap-around  Cakes  place,  so,  for 
example,  if  Che  plcCure  is  scrolled  2  pixels  In  Che  +X  dlrecdon,  all 
columns  of  Che  plcCure  will  move  2  columns  Co  Che  righc,  wich  columns  0  and 
1  being  replaced  by  Che  former  concencs  of  columns  510  and  511. 

Command  formac:  SCROLL  x-moves  (y-moves) 
or  SCROLL  reseC 

ParameCers:  x-moves  -  Che  number  of  pixels  of  horizonCal  movemenC 

y-moves  -  che  number  of  pixels  of  verCical  movemenc 

or  resec  -  inscrucdon  Co  reseC  Che  scroll  off  sec 
If  y-moves  is  omlcced,  ic  is  assumed  Co  be  zero. 

If  resec  is  specified,  any  previous  scroll  ChaC  was  issued  is  cancelled, 
and  che  plcCure  reCurns  Co  ics  original  posidon.  In  specifying  reseC,  ic 
can  be  abbreviaCed  Co  1  leCCer. 

5.2.15  SET  Command 

This  command  alCers  all  pixels  on  each  acClve  screen  Co  a  nomlnaCed 
colour.  The  CLEAR  command  (secdon  5.2.4)  is  a  special  case  of  Chls,  in 
which  che  nomlnaCed  colour  is  zero. 

Command  formac :  SET  colour 

ParameCers:  colour  -  number  in  colour  map  for  Che  screen  colour 

5.2.16  SHOW  Command 

This  command  is  used  Co  display,  on  each  acClve  screen,  a  plcCure  stored 
in  a  file  which  conCalns  che  colour  map  number  for  each  pixel  of  inceresc  . 
The  SHOW  command  allows  che  plcCure  Co  be  CranslaCed  horizoncallv  and/or 
vercically  before  1C  is  displayed. 

Note  that  for  large  pictures,  this  may  not  be  the  most  efflcent  use  of 
storage  -  a  full  picture  would  require  over  500  disk  blocks  if  stored  ir. 
this  way.  A  more  compact  form  may  be  achieved  by  converting  the  Pixel 
colour  Information  into  set  and  incremental  move  instructions.  This  can  be 
done  using  subroutine  PI(L.TO_JNSTR  in  the  FLISGRAPH  package  (see  section 
4.7.6)  or  by  using  the  ZOOM  command  (see  section  5.2.18).  The  subseauent 
picture  can  be  displayed  from  Its  new  file  with  the  FRAME  command  (see  sec¬ 
tion  5.2.10). 


Use  of  the  SHOW  coarsand  requires  that  the  file  be  set  up  as  a  FORTRAN 
binary  file.  The  picture  to  be  displayed  oust  be  a  rectangle  within  the 
screen  (or  the  whole  screen),  and  lnforaation  for  each  pixel  within  the 
rectangle  aust  be  stored  in  the  FORTRAN  binary  file  as  one  record  set  out  in 
the  following  foraat : 

left  ■  pixel  number  of  the  rectangle's  left  edge  integer** 

right  ■  pixel  nuaber  of  the  rectangle's  right  edge  integer** 

bottom  *  row  number  of  the  rectangle's  bottom  edge  Integer** 

top  “  row  nuaber  of  the  rectangle's  top  edge  Integer** 

plctureCleft :right ,bottoa:top)  loglcal*l  array 

Note  that  the  dimensions  of  the  two-dimensional  picture  array  must  cor¬ 
respond  with  the  rectangle  edges. 

Command  format:  SHOW  filename  [x-offset  (y-offsetl) 

Parameters:  filename  -  the  name  of  the  binary  file  containing  the 

picture 

x-offset  -  the  number  of  pixels  that  the  picture  is  to  be 
displaced  horizontally  before  showing 

y-offset  -  the  number  of  pixels  that  the  picture  Is  to  be 
displaced  vertically  before  showing 

If  offset  values  are  omitted,  they  are  assumed  to  be  zero.  Note  that  an 
x-offset  must  be  specified  if  a  y-offset  Is  to  be  specified. 

5.2.17  VIEHMAP  Command 

This  command  allow  a  user  to  see  the  colours  In  the  map  of  each  active 
controller  by  displaying  a  16  by  16  array  of  rectangles  -  one  for  each 
colour.  Each  rectangle  is  labelled  In  colour  zero  with  the  colour  number  of 
the  rectangle.  The  VIEWMAP  command  allows  the  user  to  select  a  particular 
quadrant  for  the  displaying  of  its  mao.  Note  that  selecting  a  quadrant  al¬ 
ters  the  current  colour  map  quadrant  to  that  value. 

Command  format:  VIEWMAP  [quadrant -number ] 

Parameter:  quad rant -number  -  the  number  of  the  quadrant  whose  colour 

map  is  to  be  viewed.  The  current 
quadrant -number  is  left  at  this  value. 

If  quadrant -number  is  omitted,  the  current  quadrant  Is  used. 

5.2.18  ZOOM  Command 

The  ZOOM  command  allows  a  user  to  "zoom"  in  on  the  picture  which  is  cur¬ 
rently  on  the  screen.  The  user  can  select  a  point  on  the  screen  to  be  the 
new  picture  centre,  and  then  specif iy  a  magnification,  M.  The  picture  is 
then  displayed  with  one  pixel  of  the  original  picture  being  represented  by 
an  M  by  M  rectangular  array  of  pixels.  Note  that  only  one  screen  can  be  ac¬ 
tive  for  this  command  to  execute  successfully  -  if  there  is  more  than  one 
screen  currently  active  an  error  message  will  be  given  and  MANPIX  will 
request  another  command. 

Command  format :  ZOOM 

This  command  has  no  parameters  -  a  dialogue  is  conducted  with  the  user 
to  determine  requirements.  When  MANPIX  ZOOM  Is  tvped  to  the  "$",  or  lust 
ZOOM  to  the  MANPIX  prompt  "Command:",  the  program  tyoes  the  following 

message : 
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Reading  back  Che  picture... 

This  operation  takes  10  to  IS  seconds.  Once  the  picture  has  been  read.  MAN- 
P1X  draws  a  pair  of  cross  hairs  in  the  centre  of  the  screen.  The  user  will 
be  asked  to  enter  comaands  which  will  move  the  cross  to  the  desired  centre 
of  the  enlarged  picture.  The  cross  is  shown  in  colour  zero.  However,  this 
may  be  unsuitable  if  the  picture  consists  of  a  small  coloured  region  with  a 
large  black  background,  because  the  cross  will  be  indistinguishable. 
Hence,  MANPIX  asks  the  following  question  first: 

Cross  colour  ok?  (Type  Y  or  new  colour  number): 

At  this  point  the  user  either  enters  Y  or  a  new  colour  number.  If  a  new  num¬ 
ber  is  entered,  the  question  is  asked  again.  Once  the  user  has  entered  Y, 
the  following  is  asked 

Move  cross  to  new  centre  (Up,  Down,  left.  Right,  or  0)? 

The  user  can  now  enter  commands  to  re-locate  the  cross  to  the  desired  cen¬ 
tre.  Such  commands  consist  of  one  of  the  letters  U,  D,  L,  or  R  optionally 
followed  by  a  number.  These  will  move  the  cross  the  stated  number  of  pixels 
up,  down,  left  or  right.  If  the  number  of  pixels  is  omitted,  it  is  assumed 
to  be  1.  If  a  command  moves  the  cross  beyond  a  screen  boundary,  it  is  placed 
at  that  boundary.  Each  time  the  user  enters  a  command,  the  cross  is  shifted 
and  a  shortened  form  of  the  question  is  asked: 

Move  cross? 

The  short  form  is  used  from  then  onwards  unless  an  invalid  command  is  en¬ 
tered  when  the  long  form  is  re-used.  The  user  should  continue  this 
procedure  until  the  cross  is  at  its  desired  location,  and  then  answer  the 
question  with  0  (zero).  MANPIX  will  then  respond: 

Enter  magnification  (0  if  done): 

The  user  can  then  enter  the  desired  magnification.  MANPIX  will  display  the 
enlarged  picture,  and  then  ask  again  for  magnification.  When  the  user  has 
finished  looking  at  the  picture  at  various  magnifications,  a  zero  should  he 
entered.  MANPIX  will  then  ask 

Now  what  -  S(ave  on  file,  M(ore  of  this,  E(xit? 

The  user  should  respond  with  S,  M,  or  E.  M  will  return  to  the  cross  hairs 
level,  so  that  the  same  picture  can  be  enlarged  about  a  different  centre.  E 
will  cause  MANPIX  to  return  to  the  command  level.  Swill  result  in  the  fol¬ 
lowing  request : 

Enter  filename: 

The  user  should  enter  a  valid  VAX  Files-11  filename  and  MANPIX  will  then 
convert  the  current  picture  into  a  se"  .'nee  of  graphic  instructions  and 
store  them  in  that  file.  This  picture  can  subsequently  be  re-displayed 
with  the  FRAME  command  (see  section  5.2.10).  When  the  data  has  been  stored, 
MANPIX  will  re-ask  the  question  seeking  S,  M,  or  E  as  a  response. 

The  ZOOM  command  can  be  used  to  convert  a  file  stored  as  pixel  infor¬ 
mation  (to  be  displayed  with  the  SHOW  command  -  section  5.2.1b)  into  a  file 
stored  as  a  sequence  of  graphic  Instructions  (to  he  dlsplaved  with  the 
FRAME  command  -  section  5.2.10).  This  can  be  achieved  bv  displaying  the 
picture,  and  entering  the  ZOOM  command.  Enter  Y  to  the  "Cross  colour  ok?" 
question,  and  0  to  the  "Move  cross?"  question.  Then  enter  a  magnification 
of  1,  S  to  the  "Now  what"  question  and  give  a  valid  filename  when  MANPIX 


sags 


asks  for  it.  The  resulting  file  will  contain  the  graphic  instructions 
necessary  to  generate  that  picture  from  a  clear  screen. 

5.3  Separate  Parameter  Coesands 

5.3.1  MFRAME  Command 

This  command  displays  on  each  active  screen  a  picture  stored  in  a  file 
as  a  series  of  graphic  instructions.  A  separate  file  must  be  specified  for 
each  screen  that  Is  currently  active.  It  Is  similar  to  the  FRAME  command 
(section  5.2.10)  except  that  no  frame-number  can  be  specified  -  this  com¬ 
mand  only  displays  the  first  frame  of  each  file.  Each  file  must  be  set  up  as 
a  FORTRAN  binary  file  as  described  in  section  5.2.10. 

Command  format:  MFRAME  file-1  (1  active  acreen) 

or  MFRAME  file-1  file-2  (2  active  screens) 

or  MFRAME  file-1  file-2  file-3  (3  active  screens) 

Parameters:  file-n  -  the  name  of  the  binary  file  containing  the 

frame(s)  of  graohic  instructions  for  the  n-th 
screen  in  the  list  of  those  currently  active 

Note  that  "MFRAME  file  file  file"  has  the  same  effect  as  "FRAME  file" 
when  all  three  screens  are  active;  similar  command  pairs  are  equivalent 
when  there  are  one  or  two  screens  active. 

5. 3. 2  MOVIE  Command 

This  command  is  used  to  show  a  sequence  of  picture  frames  stored  in  a 
file  as  a  moving  sequence.  A  file  must  be  supplied  for  each  screen  that  is 
currently  active,  and  each  frame  of  each  file  must  be  set  up  as  one  record 
of  a  FORTRAN  binary  file  in  exactly  the  sane  format  as  required  for  the 
FRAME  command  (see  section  5.2.10).  The  instructions  necessary  for  conver¬ 
ting  one  picture  frame  into  another  can  be  generated  using  subroutine  UP- 
DATE_PI CTURE  of  the  FLISGRAPH  package  (see  section  4.7.3). 

The  rate  at  which  the  frame  sequence  is  updated  can  be  specified  by  the 
user  as  a  multiple  of  10  milliseconds.  Alternatively,  the  user  can  request 
that  the  display  of  the  graphic  instructions  be  delayed  by  the  controller 
so  that  the  picture  is  synchronized  with  either  the  frame  (25  Hz)  or  field 
(50  Hz)  update.  Synchronization  with  the  frame  update  is  the  recommended 
way  of  showing  a  moving  sequence  at  25  frames  per  second. 

Command  format:  MOVIE  file-1  (sync-or-interval] 

or  MOVIE  file-1  file-2  (sync-or-interval] 

or  MOVIE  file-1  file-2  file-3  [sync-or-interval] 

Parameters:  file-n  -  the  name  of  the  binary  file  containing  the  frames 

of  graphic  instructions  for  the  n-th  screen  in 
the  list  of  those  currently  active 

sync-or-interval  -  time  interval  or  synchronization 

specification 

(i)  interval  -  the  time  interval  between  updates  from  one 
frame  to  the  next.  Note  that  this,  if 
specified,  must  he  expressed  in  millisec, 
and  must  be  a  multiple  of  10  millisec. 

(11)  sync  -  must  he  either  "field"  or  "frame"  and  if 
specified,  transfer  of  the  graphic  in¬ 
structions  to  the  controller  will  be 
delayed  accordingly. 
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If  sync-or-interval  is  omitted  or  specified  as  0,  the  sequence  will  he 
shown  as  fast  as  possible.  Note  that  the  sequence  is  shown  over  and  over 
again  until  the  user  enters  a  carriage  return* 

If  a  requested  update  rate  is  too  high  (because  other  users  are  asking 
heavy  demands  on  the  system,  or  because  there  is  a  very  large  number  of 
graphic  instructions  per  frame  to  transmit)  an  error  condition  will  result. 
MANPIX  will  display  an  error  message  and  return  to  command  level.  The  error 
message  will  be  of  the  form: 

***  Interval  too  short  -  overrun  in  pass  no.  ppppp  frame  no.  fffff 

where  ppppp  is  the  number  of  the  current  Iteration  through  the  moving 
sequence  and  fffff  is  the  number  of  the  frame  whose  transmission  caused  the 
overrun. 

S. 3.3  MSHOW  Command 

This  command  displays  on  each  active  screen  a  picture  stored  In  a  file 
as  pixel  Information.  A  separate  file  must  be  specified  for  each  screen 
that  is  currently  active.  This  command  is  similar  to  the  SHOW  command  (sec¬ 
tion  5.2.16)  except  that  offsets  cannot  be  supplied  to  translate  the  pic¬ 
ture.  The  file  format  is  the  same  as  that  described  in  section  5.2.16. 

Command  format:  MSHOW  flle-1 

or  MSHOW  file-1  file-2 

or  MSHOW  file-1  file-2  file-3 

Parameters:  flle-n  -  the  name  of  the  binary  file  containing  the  pixel 

Information  for  the  n-th  screen  in  the  list  of 
those  currently  active 

Note  that  "MSHOW  file  file  file"  has  the  same  effect  as  "SHOW  file"  when 
all  three  screens  are  active;  similar  command  pairs  are  equivalent  when 
there  are  one  or  two  screens  active. 
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APPENDIX  A 


INSTRUCTION  SET  FOR  RASTER  GRAPHIC  CONTROLLERS 


A.l  General 


ivy/ 

Itw*. 


This  appendix  details  the  instruction  set  of  the  raster  graphics  con** 
trollers.  Instructions  are  sixteen  bits,  except  for  the  Mload  colour  nap 
word"  instruction  which  is  32  bits  (expressed  as  two  16  bit  words)* 

The  following  sections  give  a  brief  description  and  the  bit  pattern  for 
each  instruction.  Note  that  in  sone  cases*  not  all  of  the  16  bits  are  used  ~ 
in  these  cases*  the  unused  bits  are  shown  as  asterisks  ("*")  in  the  bit  pat** 
tern.  All  bit  patterns  show  the  nost  significant  bit  at  the  left. 


A.  2  Set  Colour  Code 

This  Instruction  changes  the  value  in  the  controller’s  colour  code 
register  to  the  value  specified  in  its  least  significant  8  bits.  This 
colour  is  used  in  all  future  instructions  which  write  into  the  raster 
■enory  (until  changed  by  another  "set  colour  code"  instruction).  A  bit  is 
provided  in  this  instruction  as  a  flag  to  indicate  whether  or  not  all 
pixels  are  to  be  set  to  the  new  colour.  Thus*  the  screen  can  be  cleared  with 
this  Instruction  by  setting  all  pixels  to  colour  0  (provided  that  colour  0 
has  been  set  up  as  black  in  the  colour  nap). 


W 


Bit  pattern: 


where 


AAAAAAAA 

S 


0010S***AAAAAAAA 


(bits  0-7)  -  colour  (address  in  the  colour  nap  (0-255)) 
(bit  11)  -  flag  to  set  all  pixels  to  the  new  colour 


A.  3  Set  X  Coordinate 

This  instruction  nodifles  the  controller’s  x  coordinate  holding 
register  to  the  value  specified  in  its  least  significant  9  bits,  and 
together  with  the  "set  y  coordinate"  instruction,  allows  individual  pixels 
to  be  referenced.  A  bit  is  provided  as  a  flag  to  indicate  whether  or  not  the 
pixel  being  referenced  (by  the  updated  x  and  y  coordinate  holding 
registers)  is  to  be  set  to  the  prevailing  colour  (as  set  up  with  the  most 
recent  "set  colour  code"  instruction). 


Bit  pattern: 


where 


XXXXXXXXX 

W 


oooow**xxxxxxxxx 


(bits  0-8)  ■  new  value  for  the  x  coordinate 
(bit  11)  *  flag  to  set  referenced  pixel  to  the 
prevailing  colour 


A.  A  Set  T  Coordinate 

This  Instruction  modifies  the  controller’s  v  coordinate  holding 
register  in  the  same  manner  that  the  "set  x  coordinate"  instruction 
modifies  the  x  coordinate  holding  register.  As  In  the  case  of  that  instruc¬ 
tion,  a  bit  is  provided  to  indicate  whether  or  not  the  referenced  pixel  is 
to  be  set  to  the  prevailing  colour. 


ak&a.  mo* 


Bit  pattern: 


0001W*  *YYYYYY¥YY 


where 

YYYYYYYYY  (bits  0-8)  ■  new  value  for  the  y  coordinate 

W  (bit  11)  »  flag  to  aet  referenced  pixel  to  the 
prevailing  colour 


A.S  Set  Mask 

This  Instruction  sets  the  controller's  mask  register*  This  register  Is 
used  to  determine  which  of  the  controller's  eight  memory  planes  can  be 
written.  Setting  one  of  the  mask  bits  to  aero  prevents  modification  of  the 
corresponding  bit  plane,  with  the  result  that  only  a  subset  of  the  full  256 
colours  may  be  written. 


Bit  pattern:  001  1  0***MMMMMMMM 

where 

MMMMMMMM  (bits  0-7)  ■  new  value  for  the  mask 


A. 6  Select  Write  Colour  Nap  Quadrant 

As  discussed  in  section  2,  the  graphic  controller  has  four  colour  map 
quadrants,  with  each  storing  the  red,  green  and  blue  components  of  a  set  of 
256  colours.  This  instruction  is  used  to  select  a  particular  quadrant  so 
that  one  or  more  of  its  256  colours  can  be  altered  (with  a  "load  colour  map 
word"  instruction). 


Bit  pattern:  0100**********QQ 

where 

QQ  (bits  0-1)  ■  quadrant  number  to  be  selected  (0-3) 


A.  7  Select  Display  Colour  Map  Quadrant 

This  instruction  selects  the  colour  map  quadrant  to  be  used  in  tran¬ 
slating  the  256  colours  of  the  map  into  red,  green  and  blue  values  for 
display.  A  bit  is  provided  in  this  instruction  for  enabling  and  disabling 
the  display.  Thus,  if  this  instruction  is  sent  with  this  bit  clear,  the 
screen  remains  blank  until  another  "select  display  colour  mao  quadrant" 
instruction  is  sent  with  this  bit  set. 


Bit  pattern:  0  1  0  1  E 


*  0  Q 


where 

QQ  (bits  0-1)  ■  quadrant  number  to  be  selected  (0-3) 
E  (bit  11)  *  flag  to  enable  display 


A. 8  Load  Colour  Map  Word 

This  instruction  requires  32  bits,  and  is  used  to  define  the  red,  green 
and  blue  values  for  an  entry  in  the  colour  map.  There  are  7  bits  for  red,  8 
bits  for  green,  and  6  bits  for  blue.  There  is  also  one  bit  provided  to 


Indicate  whether  or  not  this  colour  will  be  detectable  by  a  light  pen.  The 
quadrant  used  Is  that  selected  by  the  nost  recent  "set  write  colour  map 
quadrant"  Instruction. 


! 


Bit  pattern:  1  1BBBBBBAAAAAAAA 

LRRRRRRRGGGGGGGG 

where 

AAAAAAAA  (bits  0-7)  ■  address  In  the  colour  map  (0-255) 

BBBBBB  (bits  8-13)  »  blue  level  for  this  colour  (0-63) 
GGGGGGGG  (bits  16-23)  •  green  level  for  this  colour  (0-255) 
RRRRRRR  (bits  24-30)  »  red  level  for  this  colour  (0-127) 

L  (bit  31)  ■  flag  to  make  this  colour  detectable  by  a 
light  pen 


A. 9  Incremental  Hove 

This  Instruction  alters  the  controller's  x  and  y  coordinate  registers  by 
a  requested  number  of  steps  In  any  of  the  eight  cardinal  directions.  A  bit 
is  provided  to  Indicate  whether  or  not  pixels  traversed  in  the  "move"  are 
to  be  set  to  the  prevailing  colour  (as  set  up  with  the  most  recent  "set 
colour  code"  Instruction).  Thus,  this  instruction  is  most  useful  for  fil¬ 
ling  In  all  or  part  of  a  row,  column  or  diagonal  line  of  pixels. 


Bit  pattern:  1  OWXLYDCCCCCCCCC 

where 

CCCCCCCCC  (bits  0-8)  -  repeat  count  -  number  of  steps  to  move 

(0-511) 

D  (bit  9)  ■  flag  to  Indicate  y  move  Is  negative 

(downwards) 

Y  (bit  10)  -  flag  to  request  a  y-dlrectional  move 

L  (bit  11)  *  flag  to  indicate  x  move  Is  negative 

( leftwards) 

X  (bit  12)  ■  flag  to  request  an  x-directlonal  move 

U  (bit  13)  ■  flag  to  Indicate  that  all  pixels  traversed 

are  to  be  set  to  the  prevailing  colour 


V 


A.  10  Scroll 

This  instruction  causes  the  picture  on  the  screen  to  be  scrolled  by  one 
pixel  In  any  of  the  eight  cardinal  directions.  The  picture  wraps  around  so 
that,  for  example,  column  511  becomes  column  0  if  a  scroll  in  the  positive  x 
direction  Is  performed. 


Bit  pattern:  01  1  0  ***»“*  0  X  L  Y  D 

where 

D  (bit  0)  ■  flag  to  Indicate  y  scroll  Is  negative 

(downwards) 

Y  (bit  1)  »  flag  to  request  a  one  pixel  scroll  in  the 

y  direction 

L  (bit  2)  »  flag  to  indicate  x  scroll  Is  negative 

(leftwards) 


X 


(bit  3)  ■  flag  to  request  a  one  pixel  scroll  In  the 
x  direction 


A.  11  Scroll  Asset 

This  instruction  resets  the  x  and  y  scroll  offsets  which  have  been  set 
up  with  any  previous  scroll  Instructions.  Thus,  a  "scroll  reset"  Instruc¬ 
tion  will  cause  a  previously  scrolled  picture  to  return  to  its  original 
position  on  the  screen. 


Bit  pattern:  0110*******! 


A. 12  Synchronise  Controller 

This  Instruction  causes  the  transmission  of  all  following  instructions 
to  be  delayed,  so  that  a  picture  update  can  be  synchronised  with  the  field 
or  frame  blanking  Interval  of  the  display  monitor.  A  bit  is  provided  to 
Indicate  whether  transmission  is  to  be  delayed  until  the  next  field  blank 
(start  of  scan  line  295  or  607)  or  until  the  next  frame  blank  (start  of  scan 
line  607). 


Bit  pattern:  001  1  l*******ee*F 

where 

F  (bit  0)  »  flag  to  Indicate  Aether  transmission  is 

to  be  delayed  until  field  blank  (clear)  or 
frame  blank  (set) 


A.  13  Save 

This  instruction  allows  part  or  all  of  a  row  or  column  of  pixels  to  be 
copied  from  the  controller’s  memory  planes  into  the  host  LSI’s  memory.  The 
copying  starts  at  the  pixel  represented  by  the  current  controller  x  and  y 
coordinates,  with  N  pixels  being  copied,  where  N  is  one  more  than  the  count 
in  the  least  significant  9  bits  of  the  Instruction.  Each  pixel  is  stored  as 
a  byte  in  the  LSI  memory  starting  at  the  next  location  following  this 
"save”  instruction.  A  bit  is  provided  to  indicate  whether  the  copy  is  to  be 
performed  across  a  row  (x  direction)  or  up  a  column  (y  direction).  The 
copying  always  takes  place  in  the  positive  direction. 


Bit  pattern:  01  1  10P*NNNNNNNNN 

where 

NNNNNNNNN  (bits  0-8)  ■  ONE  LESS  THAN  the  number  of  pixels  to  save 

(0-511  representing  1-512  pixels) 

P  (bit  11)  ■  flag  to  Indicate  path  of  save  -  clear  for 
x  direction,  set  for  y  direction 


A. 14  Restore 

This  instruction  Is  the  same  as  the  "save"  instruction  except  that  the 
transfer  of  pixel  data  is  from  the  host  LSI’s  memory  to  the  graphic  control¬ 
ler’s  memory.  Thus,  this  instruction  can  he  used  to  restore  part  or  all  of 


•  row  or  column  of  pixels  previously  stored  with  the  "save"  Instruction. 
Each  pixel  Is  retrieved  from  a  byte  In  the  LSI  memory  starting  at  the  next 
location  following  this  "restore"  Instruction. 


Bit  pattern:  01  1  1  1  P*NNNNNNNNN 

where 

NNNNNNNNN  (bits  0-8)  »  ONE  LESS  THAN  the  number  of  pixels  to  be 

restored  (0-511  representing  1-512  pixels) 
P  (bit  11)  ■  flag  to  Indicate  path  of  restore  -  clear 
for  x  direction,  set  for  y  direction 


APPENDIX  B 


PRIMARY  BOOTSTRAP  FOR  USE  WITH  PROGRAM  LSILOAD 


The  primary  bootstrap  is  as  follows,  and  should  be  loaded  into  the  host 
LSI  starting  at  address  157720  (octal).  Note  that  all  numbers  in  this  ap- 
pendix  are  octal  Integers. 


157720 

12701 

MOV 

#157534, R1 

157722 

157534 

157724 

12702 

MOV 

#2,R2 

157726 

2 

157730 

113700 

1$:  MOVB  §#DRBCSR+1,R0 

157732 

172425 

157734 

113703 

MOVB  @#DRBCSR,R3 

157736 

172424 

157740 

74300 

X0R 

R3,R0 

157742 

30200 

BIT 

R2,R0 

157744 

1771 

BEQ 

1$ 

157746 

13721 

MOV 

j»#DRBINP,(Rl)+ 

157750 

172426 

157752 

74237 

XOR 

R2,0#DRBCSR 

157754 

172424 

157756 

764 

BR 

1$ 

The  Interface  between  the  VAX-i 1/780  and  the  LSI-1 1/23  comprises  a 
DR11-W  (on  the  VAX)  coupled  to  a  DRV11-B  (on  the  LSI).  Ihese  fora  the  DMA 
link  between  the  VAX  and  LSI.  For  program  loading,  however,  the  DR11-V  and 
DRVU-B  are  used  solely  as  a  register  Interface,  so  that  the  primary  boot¬ 
strap  can  be  as  simple  as  possible.  This  is  because  the  primary  bootstrap 
has  to  be  keyed  in  by  hand  on  some  LSI  microcomputers. 

In  the  code  above,  DRBCSR  is  the  address  of  the  DRV11-B  control/status 
register  (172424  octal)  and  DRBINP  is  the  DRV11-B  input  buffer  register 
(172426  octal).  The  DR11-W  and  DRV11-B  are  coupled  such  that  the  input  buf¬ 
fer  register  of  each  is  the  output  buffer  register  of  the  other,  and  vice 
versa.  Communication  is  achieved  via  the  two  bits  in  the  control /status 
register  (CSR)  termed  the  "FUNCT1"  and  "STATC"  bits.  When  the  FUNCT1  bit  is 
altered  in  one  CSR,  the  STATC  bit  changes  accordingly  in  the  other  CSR. 

The  VAX  sends  data  to  the  LSI  using  the  following  algorithm: 


Step  1.  Wait  for  the  FUNCT1  and  STATC  bits  in  the  CSR  of  the  DR11-W  to 
be  the  same. 

Step  2.  Write  data  into  the  output  buffer  register  of  the  DR11-W. 
Step  3.  Alter  the  FUNCT1  bit  in  the  CSR  of  the  DR11-V. 


The  LSI  receives  data  from  the  VAX  using  the  following  algorithm: 


Step  1.  Wait  for  the  FUNCT1  and  STATC  bits  in  the  CSR  of  the  DRV11-B 
to  be  different. 

Step  2.  Copy  data  from  the  input  buffer  register  of  the  DRV11-B  into 
memory. 

Step  3.  Alter  the  FUNCT1  bit  in  the  CSR  of  the  DRV11-B. 
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Flight  simulation  work  at  Aeronautical  Research  Laboratories 
employs  raster  graphics  for  both  the  presentation  of  visual  scenes 
with  limited  dynamic  content  and  for  the  replication  of  both 
flight  instruments  and  sensor  displays.  The  raster  graphics  system 
consists  of  an  LSI-11/23  microprocessor  (functioning  as  host)  and 
three  A.R.L.  designed  controller  units  coupled  to  RGBS  monitors,  and 
is  connected  through  the  LSI-11/23  to  the  Flight  Simulation  Group 
VAX-11/780  computer.  This  Memorandum  describes  the  raster  graphic 
system,  and  four  software  packages  which  are  available  to  enable  a 
VAX  user  to  create  a  manipulate  pictures.  These  packages  are:  RJRLSI, 
which  runs  in  the  LSI-11/23  for  communication;  LSILOAD,  for  loading 
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and  executing  LSI  programs;  FLISGRAPH,  a  set  of  subroutines  for  creating 
and  manipulating  pictures;  and  MANPIX,  a  utility  program  which  provides 
a  versatile  range  of  picture  manipulation  capabilities  through  a  single 
set  of  commands. 
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